#include <SFXMailUtility.h.hpp>

class SFXMailUtility;

SFMTYPEDEFCLASS(SFXMailUtility)

[ public, static ]
SFCError DecodeBase64(
    ACharConstPtr in   // pointer to the data encoded in the Base64 format
    UInt32 size        // size of the data encoded in the Base64 format
    SFXBufferPtr out   // pointer to the output buffer
);

[ public, static ]
SFCError DecodeBase64(
    SFXBufferConstRef in   // reference to the data encoded in the Base64 format
    SFXBufferPtr out       // pointer to the output buffer
);

[ public, static ]
SFCError DecodeBase64(
    SFXAnsiStringConstRef in   // reference to the data encoded in the Base64 format
    SFXAnsiStringPtr out       // pointer to the output buffer
);

[ public, static ]
SFCError DecodeQuotedPrintable(
    ACharConstPtr in   // pointer to the data encoded in the Quoted-Printable format
    UInt32 size        // size of the data encoded in the Quoted-Printable format
    SFXBufferPtr out   // pointer to the output buffer
    Bool text = true   // text mode
);

[ public, static ]
SFCError DecodeQuotedPrintable(
    SFXBufferConstRef in   // reference to the data encoded in the Quoted-Printable format
    SFXBufferPtr out       // pointer to the output buffer
    Bool text = true       // text mode
);

[ public, static ]
SFCError DecodeQuotedPrintable(
    SFXAnsiStringConstRef in   // reference to the data encoded in the Quoted-Printable format
    SFXAnsiStringPtr out       // pointer to the output buffer
    Bool text = true           // text mode
);

[ public, static ]
SFCError EncodeBase64(
    ACharConstPtr in                           // pointer to the data to be encoded
    UInt32 size                                // data size
    SFXBufferPtr out                           // pointer to the output buffer
    UInt32 chars = 64                          // number of characters per line
    SFXAnsiStringConstRef delimiter = "\r\n"   // line feed and carriage return characters
);

[ public, static ]
SFCError EncodeBase64(
    SFXBufferConstRef in                       // reference to the data to be encoded
    SFXBufferPtr out                           // pointer to the output buffer
    UInt32 chars = 64                          // number of characters per line
    SFXAnsiStringConstRef delimiter = "\r\n"   // line feed and carriage return characters
);

[ public, static ]
SFCError EncodeBase64(
    SFXAnsiStringConstRef in                   // reference to the data to be encoded
    SFXAnsiStringPtr out                       // pointer to the output buffer
    UInt32 chars = 64                          // number of characters per line
    SFXAnsiStringConstRef delimiter = "\r\n"   // CRLF characters
);

[ public, static ]
SFCError EncodeQuotedPrintable(
    ACharConstPtr in    // pointer to the data to be encoded in the Quoted-Printable format
    UInt32 size         // data size
    SFXBufferPtr out    // pointer to the output buffer
    UInt32 chars = 64   // number of characters per line
    Bool text = true    // text mode or not?
);

[ public, static ]
SFCError EncodeQuotedPrintable(
    SFXBufferConstRef in   // reference to the data to be encoded in the Quoted-Printable format
    SFXBufferPtr out       // pointer to the output buffer
    UInt32 chars = 64      // number of characters of first line
    Bool text = true       // whether text mode or not?
);

[ public, static ]
SFCError EncodeQuotedPrintable(
    SFXAnsiStringConstRef in   // reference to the data to be encoded in the Quoted-Printable format
    SFXAnsiStringPtr out       // pointer to the output buffer
    UInt32 chars = 64          // number of characters of first line
    Bool text = true           // whether text mode or not
);

[ public, static ]
Bool FindNextBoundary(
    ACharConstPtr start              // pointer to the starting position to search for the "boundary" string
    ACharConstPtr end                // pointer to the end position to search for the "boundary" string
    SFXAnsiStringConstRef boundary   // "boundary" string
    ACharConstHandle found           // handle to store the pointer  to the position of the "boundary" string to be found
    ACharConstHandle next            // handle to store the pointer  to the next position of the "boundary" string to be found
);

[ public, static ]
UInt32 GetEncodedSizeBase64(
    UInt32 size        // size of the data when encoded in the Base64 format
    UInt32 chars       // number of characters per line
    UInt32 delimiter   // length of the line feed and carriage return characters
);

[ public, static ]
UInt32 GetEncodedSizeQuotedPrintable(
    ACharConstPtr in   // data to be encoded in the Quoted-Printable format
    UInt32 size        // size of the data when encoded in the Quoted-Printable format
    UInt32 chars       // number of characters per line
    Bool text          // whether text mode or not
);

[ public, static ]
SFCError GetHMACMD5(
    VoidConstPtr in         // input data
    UInt32 size             // size of input data 
    SFXBufferConstRef key   // reference to the key 
    SFXBufferPtr out        // pointer to the output buffer
    Bool isXdigit           // whether or not to output the HMAC-MD5 as hexadecimal digits
);

[ public, static ]
SFCError GetHMACMD5(
    SFXBufferConstRef in    // input data
    SFXBufferConstRef key   // reference to the key 
    SFXBufferPtr out        // pointer to the output buffer
    Bool isXdigit           // whether or not to output the HMAC-MD5 as hexadecimal digits
);

[ public, static ]
SFCError GetHMACMD5(
    SFXAnsiStringConstRef in    // input data
    SFXAnsiStringConstRef key   // reference to the key 
    SFXAnsiStringPtr out        // pointer to the output string
    Bool isXdigit               // whether or not to output the HMAC-MD5 as hexadecimal digits
);

[ public, static ]
SFCError GetKeyedMD5(
    VoidConstPtr datagram   // input data
    UInt32 size             // size of input data 
    SFXBufferConstRef key   // reference to the key 
    AChar keyfill           // pad
    SFXBufferPtr out        // pointer to the output buffer
    Bool isXdigit           // whether or not to output the Keyed-MD5 as hexadecimal digits
);

[ public, static ]
SFCError GetKeyedMD5(
    SFXBufferConstRef datagram   // input data
    SFXBufferConstRef key        // reference to the key 
    AChar keyfill                // pad
    SFXBufferPtr out             // pointer to the output buffer
    Bool isXdigit                // whether or not to output the Keyed-MD5 as hexadecimal digits
);

[ public, static ]
SFCError GetKeyedMD5(
    SFXAnsiStringConstRef datagram   // input data
    SFXAnsiStringConstRef key        // key
    AChar keyfill                    // pad
    SFXAnsiStringPtr out             // pointer to the output string
    Bool isXdigit                    // whether or not to output the Keyed-MD5 as hexadecimal digits
);

[ public, static ]
SFCError GetMD5(
    VoidConstPtr in    // input data
    UInt32 size        // size of input data
    SFXBufferPtr out   // pointer to the output buffer
    Bool isXdigit      // whether or not to output the MD5 as hexadecimal digits
);

[ public, static ]
SFCError GetMD5(
    SFXBufferConstRef in   // input data
    SFXBufferPtr out       // pointer to the output buffer
    Bool isXdigit          // whether or not to output the MD5 as hexadecimal digits
);

[ public, static ]
SFCError GetMD5(
    SFXAnsiStringConstRef in   // input data
    SFXAnsiStringPtr out       // pointer to the output string
    Bool isXdigit              // whether or not to output the MD5 as hexadecimal digits
);

[ public, static ]
SInt16 HexToByte(
    AChar c1   // upper character of two hexadecimal digits to be converted
    AChar c2   // lower character of two hexadecimal digits to be converted
);

[ public, static ]
SInt16 HexToNibble(
    AChar c   // hexadecimal digit to be converted
);

[ public, static ]
Bool IsAtext(
    AChar c   // character to be checked
);

[ public, static ]
Bool IsCTL(
    AChar c   // character to be checked
);

[ public, static ]
Bool IsTokenChar(
    AChar c   // character to be checked
);

[ public, static ]
Bool IsTspecials(
    AChar c   // character to be checked
);

[ public, static ]
Bool IsValidFieldName(
    ACharConstPtr start        // pointer to the starting character of the field
    ACharConstPtr end = null   // pointer to the end character of the field
);

[ public, static ]
Bool IsWSP(
    AChar c   // character to be checked
);

[ public, static ]
SFCError JISToShiftJIS(
    SFXAnsiStringConstRef in   // reference to the string to be converted
    SFXAnsiStringPtr out       // pointer to the converted string
    AChar unconvChar = '\0'    // alternative character for the character that cannot be converted
);

[ public, static ]
AChar NibbleToHex(
    Byte nibble   // integre value to be converted
);

[ public, static ]
SFCError ParseAddrSpec(
    ACharConstPtr start      // pointer to the head of string to be parsed
    ACharConstPtr end        // pointer to the end of string to be parsed
    ACharConstHandle next    // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr value   // pointer to the parsing result: mail address (addr-spec)
);

[ public, static ]
SFCError ParseAtom(
    ACharConstPtr start      // pointer to the head of string to be parsed
    ACharConstPtr end        // pointer to the end of string to be parsed
    ACharConstHandle next    // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr value   // pointer to parsing result's atom
);

[ public, static ]
SFCError ParseContentType(
    SFXAnsiStringConstRef fieldValue   // string to be parsed
    SFXAnsiStringPtr mainType          // type
    SFXAnsiStringPtr subType           // subtype
    SFXPropertyPtr paramList           // parameter
);

[ public, static ]
SFCError ParseDate(
    ACharConstPtr start     // pointer to the head of string to be parsed
    ACharConstPtr end       // pointer to the end of string to be parsed
    ACharConstHandle next   // handle of the pointer to the end position to be parsed
    SFXDatePtr date         // pointer to the date
    SInt16Ptr zone          // pointer to the timezone
);

[ public, static ]
SFCError ParseDate(
    SFXAnsiStringConstRef str   // string to be parsed
    SFXDatePtr date             // pointer to the date
    SInt16Ptr zone              // pointer to the timezon
);

[ public, static ]
SFCError ParseDotAtom(
    ACharConstPtr start      // pointer to the head of string to be parsed
    ACharConstPtr end        // pointer to the end of string to be parsed
    ACharConstHandle next    // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr value   // pointer to the parsing result: dot-atom
);

[ public, static ]
SFCError ParseDotAtomText(
    ACharConstPtr start      // pointer to the head of string to be parsed
    ACharConstPtr end        // pointer to the end of string to be parsed
    ACharConstHandle next    // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr value   // pointer to the parsing result: dot-atom-text
);

[ public, static ]
SFCError ParseHeaderLine(
    ACharConstPtr start       // pointer to the head of string to be parsed
    ACharConstPtr end         // pointer to the end of string to be parsed
    ACharConstHandle next     // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr value1   // pointer to the parsing result: field name
    SFXAnsiStringPtr value2   // pointer to the parsing result: field value
);

[ public, static ]
SFCError ParseMailbox(
    ACharConstPtr start     // pointer to the head of string to be parsed
    ACharConstPtr end       // pointer to the end of string to be parsed
    ACharConstHandle next   // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr name   // pointer to the parsing result name
    SFXAnsiStringPtr addr   // pointer to the parsing result's mail address (maibox) 
);

[ public, static ]
SFCError ParseMailbox(
    SFXAnsiStringConstRef str   // string to be parsed
    SFXAnsiStringPtr name       // pointer to the parsed name
    SFXAnsiStringPtr addr       // pointer to the parsing result:  mail address (maibox) 
);

[ public, static ]
SFCError ParseMailboxList(
    ACharConstPtr start       // pointer to the head of string to be parsed
    ACharConstPtr end         // pointer to the end of string to be parsed
    ACharConstHandle next     // handle of the pointer to the end position to be parsed
    MailboxHandle mailboxes   // list of mail address
    SInt32Ptr mbxCount        // number of mail addresses
);

[ public, static ]
SFCError ParseMailboxList(
    SFXAnsiStringConstRef str   // character string to be parsed
    MailboxHandle mailboxes     // list of mail address
    SInt32Ptr mbxCount          // number of mail addresses
);

[ public, static ]
SFCError ParseParameter(
    ACharConstPtr start      // pointer to the head of string to be parsed
    ACharConstPtr end        // pointer to the end of string to be parsed
    ACharConstHandle next    // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr name    // pointer to the parsed name of parameter
    SFXAnsiStringPtr value   // pointer to the parsed value of parameter
);

[ public, static ]
SFCError ParseParameterList(
    ACharConstPtr start        // pointer to the head of string to be parsed
    ACharConstPtr end          // pointer to the end of string to be parsed
    SFXPropertyPtr paramList   // pointer to the parsing result: list of parameters
);

[ public, static ]
SFCError ParsePhrase(
    ACharConstPtr start      // pointer to the head of string to be parsed
    ACharConstPtr end        // pointer to the end of string to be parsed
    ACharConstHandle next    // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr value   // pointer to the parsing result: phrase
);

[ public, static ]
SFCError ParseQuotedString(
    ACharConstPtr start      // pointer to the head of string to be parsed
    ACharConstPtr end        // pointer to the end of string to be parsed
    ACharConstHandle next    // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr value   // pointer to the parsing result: quoted-string
);

[ public, static ]
SFCError ParseToken(
    ACharConstPtr start      // pointer to the head of string to be parsed
    ACharConstPtr end        // pointer to the end of string to be parsed
    ACharConstHandle next    // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr value   // pointer to the parsing result: token
);

[ public, static ]
SFCError ParseWord(
    ACharConstPtr start      // pointer to the head of string to be parsed
    ACharConstPtr end        // pointer to the end of string to be parsed
    ACharConstHandle next    // handle of the pointer to the end position to be parsed
    SFXAnsiStringPtr value   // pointer to the parsing result: word
);

[ public, static ]
SFCError ShiftJISToJIS(
    SFXAnsiStringConstRef in   // reference to the source string to be converted
    SFXAnsiStringPtr out       // pointer to the converted string
    AChar unconvChar = '\0'    // alternative character for the character that cannot be converted
);

[ public, static ]
Void SkipUntilCRLF(
    ACharConstHandle start   // handle that stores a pointer to the starting position to search for the next CRLF or '\0' chararacter and to the result position
);

[ public, static ]
Void SkipWSP(
    ACharConstHandle start   // [in]starting position;[out] the positon of the character other than WSP or the ending position specified
    ACharConstPtr end        // ending position
);

struct Mailbox {
    SFXAnsiString   name;  // display name
    SFXAnsiString   addr;  // addr-spec
};