#include <SFXMailUtility.h.hpp>

class SFXMailUtility;

SFMTYPEDEFCLASS(SFXMailUtility)

[ public, static ]
SFCError DecodeBase64(
    ACharConstPtr in   // [入力] Base64 エンコードされたデータへのポインタ
    UInt32 size        // [入力] Base64 エンコードされたデータのサイズ
    SFXBufferPtr out   // [出力] Base64 デコードされたデータが格納された場所へのポインタ
);

[ public, static ]
SFCError DecodeBase64(
    SFXBufferConstRef in   // [入力] Base64 エンコードされたデータへの参照
    SFXBufferPtr out       // [出力] Base64 デコードされたデータが格納された場所へのポインタ
);

[ public, static ]
SFCError DecodeBase64(
    SFXAnsiStringConstRef in   // [入力] Base64 エンコードされたデータへの参照
    SFXAnsiStringPtr out       // [出力] Base64 デコードされたデータが格納された場所へのポインタ
);

[ public, static ]
SFCError DecodeQuotedPrintable(
    ACharConstPtr in   // [入力] Quoted-Printable エンコードされたデータへのポインタ
    UInt32 size        // [入力] Quoted-Printable エンコードされたデータのサイズ
    SFXBufferPtr out   // [出力] Quoted-Printable デコードされたデータが格納された場所へのポインタ
    Bool text = true   // [入力] テキストモードかバイナリモードか: デフォルトは true（テキストモード）
);

[ public, static ]
SFCError DecodeQuotedPrintable(
    SFXBufferConstRef in   // [入力] Quoted-Printable エンコードされたデータへの参照
    SFXBufferPtr out       // [出力] Quoted-Printable デコードされたデータが格納された場所へのポインタ
    Bool text = true       // [入力] テキストモードかバイナリモードか: デフォルトは true（テキストモード）
);

[ public, static ]
SFCError DecodeQuotedPrintable(
    SFXAnsiStringConstRef in   // [入力] Quoted-Printable エンコードされたデータへの参照
    SFXAnsiStringPtr out       // [出力] Quoted-Printable デコードされたデータが格納された場所へのポインタ
    Bool text = true           // [入力] テキストモードであるかどうか: デフォルトは true。基本的にテキストモードを指定する。
);

[ public, static ]
SFCError EncodeBase64(
    ACharConstPtr in                           // [入力] Base64 エンコードするデータへのポインタ
    UInt32 size                                // [入力] Base64 エンコードするデータのサイズ
    SFXBufferPtr out                           // [出力] Base64 エンコードされたデータが格納された場所へのポインタ
    UInt32 chars = 64                          // [入力] 1 行の文字数
    SFXAnsiStringConstRef delimiter = "\r\n"   // [入力] 改行文字列
);

[ public, static ]
SFCError EncodeBase64(
    SFXBufferConstRef in                       // [入力] Base64 エンコードするデータへの参照
    SFXBufferPtr out                           // [出力] Base64 エンコードされたデータが格納された場所へのポインタ
    UInt32 chars = 64                          // [入力] 1 行の文字数
    SFXAnsiStringConstRef delimiter = "\r\n"   // [入力] 改行文字列
);

[ public, static ]
SFCError EncodeBase64(
    SFXAnsiStringConstRef in                   // [入力] Base64 エンコードするデータへの参照
    SFXAnsiStringPtr out                       // [出力] Base64 エンコードされたデータが格納された場所へのポインタ
    UInt32 chars = 64                          // [入力] 1 行の文字数
    SFXAnsiStringConstRef delimiter = "\r\n"   // [入力] 区切り文字列（1 行を区切る文字）
);

[ public, static ]
SFCError EncodeQuotedPrintable(
    ACharConstPtr in    // [入力] Quoted-Printable エンコードするデータへのポインタ
    UInt32 size         // [入力] Quoted-Printable エンコードするデータのサイズ
    SFXBufferPtr out    // [出力] Quoted-Printable エンコードされたデータが格納された場所へのポインタ
    UInt32 chars = 64   // [入力] 1 行の文字数
    Bool text = true    // [入力] テキストモードであるかどうか: デフォルトは true。基本的にテキストモードを指定する。
);

[ public, static ]
SFCError EncodeQuotedPrintable(
    SFXBufferConstRef in   // [入力] Quoted-Printable エンコードするデータへの参照
    SFXBufferPtr out       // [出力] Quoted-Printable エンコードされたデータが格納された場所へのポインタ
    UInt32 chars = 64      // [入力] 1 行の文字数
    Bool text = true       // [入力] テキストモードかバイナリモードか: デフォルトは true（テキストモード）
);

[ public, static ]
SFCError EncodeQuotedPrintable(
    SFXAnsiStringConstRef in   // [入力] Quoted-Printable エンコードするデータへの参照
    SFXAnsiStringPtr out       // [出力] Quoted-Printable エンコードされたデータが格納された場所へのポインタ
    UInt32 chars = 64          // [入力] 1 行の文字数
    Bool text = true           // [入力] テキストモードかバイナリモードか: デフォルトは true（テキストモード）
);

[ public, static ]
Bool FindNextBoundary(
    ACharConstPtr start              // [入力] 検索開始位置へのポインタ
    ACharConstPtr end                // [入力] 検索終了位置へのポインタ
    SFXAnsiStringConstRef boundary   // [入力] 境界文字列
    ACharConstHandle found           // [出力] 見つかった境界文字列の位置へのハンドル
    ACharConstHandle next            // [出力] 見つかった境界文字列の次の文字へのハンドル
);

[ public, static ]
UInt32 GetEncodedSizeBase64(
    UInt32 size        // [入力] Base64 形式にエンコードするデータのサイズ
    UInt32 chars       // [入力] 1 行の文字数
    UInt32 delimiter   // [入力] 改行文字列の長さ
);

[ public, static ]
UInt32 GetEncodedSizeQuotedPrintable(
    ACharConstPtr in   // [入力] Quoted-Printable エンコードするデータへのポインタ
    UInt32 size        // [入力] Quoted-Printable エンコードするデータのサイズ
    UInt32 chars       // [入力] 1 行の文字数
    Bool text          // [入力] テキストモードかどうか
);

[ public, static ]
SFCError GetHMACMD5(
    VoidConstPtr in         // [入力] 入力データ
    UInt32 size             // [入力] 入力データのサイズ
    SFXBufferConstRef key   // [入力] キーへの参照
    SFXBufferPtr out        // [出力] HMAC-MD5 ハッシュ値（128 ビット）が格納された場所へのポインタ
    Bool isXdigit           // [入力] 16 進数で出力するかどうか
);

[ public, static ]
SFCError GetHMACMD5(
    SFXBufferConstRef in    // [入力] 入力データ
    SFXBufferConstRef key   // [入力] キーへの参照
    SFXBufferPtr out        // [出力] HMAC-MD5 ハッシュ値（128 ビット）が格納された場所へのポインタ
    Bool isXdigit           // [入力] 16 進数で出力するかどうか
);

[ public, static ]
SFCError GetHMACMD5(
    SFXAnsiStringConstRef in    // [入力] 入力データ
    SFXAnsiStringConstRef key   // [入力] キーへの参照
    SFXAnsiStringPtr out        // [出力] HMAC-MD5 ハッシュ値（128 ビット）が格納された場所へのポインタ
    Bool isXdigit               // [入力] 16 進数で出力するかどうか
);

[ public, static ]
SFCError GetKeyedMD5(
    VoidConstPtr datagram   // [入力] 入力データ
    UInt32 size             // [入力] 入力データのサイズ
    SFXBufferConstRef key   // [入力] キーへの参照
    AChar keyfill           // [入力] パッド
    SFXBufferPtr out        // [出力] Keyed-MD5 ハッシュ値（128 ビット）が格納された場所へのポインタ
    Bool isXdigit           // [入力] 16 進数で出力するかどうか
);

[ public, static ]
SFCError GetKeyedMD5(
    SFXBufferConstRef datagram   // [入力] 入力データ
    SFXBufferConstRef key        // [入力] キーへの参照
    AChar keyfill                // [入力] パッド（キーの次の 512 バイト境界までパディングする文字）
    SFXBufferPtr out             // [出力] Keyed-MD5 ハッシュ値（128 ビット）が格納された場所へのポインタ
    Bool isXdigit                // [入力] 16 進数で出力するかどうか
);

[ public, static ]
SFCError GetKeyedMD5(
    SFXAnsiStringConstRef datagram   // [入力] 入力データ
    SFXAnsiStringConstRef key        // [入力] キー
    AChar keyfill                    // [入力] パッド（キーの次の 512 バイト境界までパディングする文字）
    SFXAnsiStringPtr out             // [出力] Keyed-MD5 ハッシュ値（128 ビット）が格納された場所へのポインタ
    Bool isXdigit                    // [入力] 16 進数で出力するかどうか
);

[ public, static ]
SFCError GetMD5(
    VoidConstPtr in    // [入力] 入力データ
    UInt32 size        // [入力] 入力データのサイズ
    SFXBufferPtr out   // [出力] MD5 ハッシュ値（128 ビット）が格納された場所へのポインタ
    Bool isXdigit      // [入力] 16 進数で出力するかどうか
);

[ public, static ]
SFCError GetMD5(
    SFXBufferConstRef in   // [入力] 入力データ
    SFXBufferPtr out       // [出力] MD5 ハッシュ値（128 ビット）が格納された場所へのポインタ
    Bool isXdigit          // [入力] 16 進数で出力するかどうか
);

[ public, static ]
SFCError GetMD5(
    SFXAnsiStringConstRef in   // [入力] 入力データ
    SFXAnsiStringPtr out       // [出力] MD5 ハッシュ値（128 ビット）が格納された場所へのポインタ
    Bool isXdigit              // [入力] 16 進数で出力するかどうか
);

[ public, static ]
SInt16 HexToByte(
    AChar c1   // [入力] 変換する 2 桁の 16 進数の上位桁の文字
    AChar c2   // [入力] 変換する 2 桁の 16 進数の下位桁の文字
);

[ public, static ]
SInt16 HexToNibble(
    AChar c   // [入力] 変換する 16 進数（文字）
);

[ public, static ]
Bool IsAtext(
    AChar c   // [入力] 判定する文字
);

[ public, static ]
Bool IsCTL(
    AChar c   // [入力] 判定する文字
);

[ public, static ]
Bool IsTokenChar(
    AChar c   // [入力] 判定する文字
);

[ public, static ]
Bool IsTspecials(
    AChar c   // [入力] 判定する文字
);

[ public, static ]
Bool IsValidFieldName(
    ACharConstPtr start        // [入力] 文字列の先頭へのポインタ
    ACharConstPtr end = null   // [入力] 文字列の終端へのポインタ: デフォルト値は '\0'（この場合、'\0' 文字が終端になる）
);

[ public, static ]
Bool IsWSP(
    AChar c   // [入力] 判定する文字
);

[ public, static ]
SFCError JISToShiftJIS(
    SFXAnsiStringConstRef in   // [入力] 変換元の JIS コード文字列への参照
    SFXAnsiStringPtr out       // [出力] 変換後の Shift_JIS コード文字列が格納された場所へのポインタ
    AChar unconvChar = '\0'    // [入力] 変換できない文字の代替文字: デフォルト値は '\0'（代替文字は使用されない）
);

[ public, static ]
AChar NibbleToHex(
    Byte nibble   // [入力] 変換する数値（0 〜 15）
);

[ public, static ]
SFCError ParseAddrSpec(
    ACharConstPtr start      // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end        // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next    // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr value   // [出力] 解析結果のメールアドレス（addr-spec）が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseAtom(
    ACharConstPtr start      // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end        // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next    // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr value   // [出力] 解析結果の atom が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseContentType(
    SFXAnsiStringConstRef fieldValue   // [入力] 解析対象文字列
    SFXAnsiStringPtr mainType          // [出力] 解析結果の Content-Type の type が格納された場所へのポインタ
    SFXAnsiStringPtr subType           // [出力] 解析結果の Content-Type の subType が格納された場所へのポインタ
    SFXPropertyPtr paramList           // [出力] 解析結果の パラメータリストが格納された場所へのポインタ
);

[ public, static ]
SFCError ParseDate(
    ACharConstPtr start     // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end       // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next   // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXDatePtr date         // [出力] 日時が格納された場所へのポインタ
    SInt16Ptr zone          // [出力] タイムゾーンが格納された場所へのポインタ
);

[ public, static ]
SFCError ParseDate(
    SFXAnsiStringConstRef str   // [入力] 解析対象文字列
    SFXDatePtr date             // [出力] 解析結果の日時が格納された場所へのポインタ
    SInt16Ptr zone              // [出力] 解析結果のタイムゾーンが格納された場所へのポインタ
);

[ public, static ]
SFCError ParseDotAtom(
    ACharConstPtr start      // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end        // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next    // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr value   // [出力] 解析結果の dot-atom が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseDotAtomText(
    ACharConstPtr start      // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end        // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next    // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr value   // [出力] 解析結果の dot-atom-text が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseHeaderLine(
    ACharConstPtr start       // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end         // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next     // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr value1   // [出力] 解析結果のフィールド名が格納された場所へのポインタ
    SFXAnsiStringPtr value2   // [出力] 解析結果のフィールド値が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseMailbox(
    ACharConstPtr start     // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end       // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next   // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr name   // [出力] 解析結果の名前が格納された場所へのポインタ
    SFXAnsiStringPtr addr   // [出力] 解析結果のメールアドレス（mailbox）が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseMailbox(
    SFXAnsiStringConstRef str   // [入力] 解析対象文字列
    SFXAnsiStringPtr name       // [出力] 解析結果の名前が格納された場所へのポインタ
    SFXAnsiStringPtr addr       // [出力] 解析結果のメールアドレス（mailbox）が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseMailboxList(
    ACharConstPtr start       // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end         // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next     // [出力] 次の解析対象文字列の先頭へのハンドル
    MailboxHandle mailboxes   // [出力] 解析結果のメールアドレスのリストが格納された場所へのハンドル
    SInt32Ptr mbxCount        // [出力] 解析結果のメールアドレスの数が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseMailboxList(
    SFXAnsiStringConstRef str   // [入力] 解析対象文字列
    MailboxHandle mailboxes     // [出力] 解析結果のメールアドレスのリストが格納された場所へのハンドル
    SInt32Ptr mbxCount          // [出力] 解析結果のメールアドレスの数が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseParameter(
    ACharConstPtr start      // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end        // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next    // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr name    // [出力] 解析結果の属性名（attribute）が格納された場所へのポインタ
    SFXAnsiStringPtr value   // [出力] 解析結果の属性値（value）が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseParameterList(
    ACharConstPtr start        // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end          // [入力] 解析対象文字列の終端へのポインタ
    SFXPropertyPtr paramList   // [出力] 解析結果のパラメータリストが格納された場所へのポインタ
);

[ public, static ]
SFCError ParsePhrase(
    ACharConstPtr start      // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end        // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next    // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr value   // [出力] 解析結果の phrase が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseQuotedString(
    ACharConstPtr start      // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end        // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next    // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr value   // [出力] 解析結果の quoted-string が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseToken(
    ACharConstPtr start      // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end        // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next    // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr value   // [出力] 解析結果の token が格納された場所へのポインタ
);

[ public, static ]
SFCError ParseWord(
    ACharConstPtr start      // [入力] 解析対象文字列の先頭へのポインタ
    ACharConstPtr end        // [入力] 解析対象文字列の終端へのポインタ
    ACharConstHandle next    // [出力] 次の解析対象文字列の先頭へのハンドル
    SFXAnsiStringPtr value   // [出力] 解析結果の word が格納された場所へのポインタ
);

[ public, static ]
SFCError ShiftJISToJIS(
    SFXAnsiStringConstRef in   // [入力] 変換元の Shift_JIS コード文字列への参照
    SFXAnsiStringPtr out       // [出力] 変換後の JIS コード文字列が格納された場所へのポインタ
    AChar unconvChar = '\0'    // [入力] 変換できない文字の代替文字: デフォルト値は '\0'（代替文字は使用されない）
);

[ public, static ]
Void SkipUntilCRLF(
    ACharConstHandle start   // [入力] 探索のスタート位置へのポインタ、[出力] 次の CRLF の次の文字または '\0' 文字の位置へのポインタ
);

[ public, static ]
Void SkipWSP(
    ACharConstHandle start   // [入力] 探索のスタート位置へのポインタ、[出力] WSP（空白文字または水平タブ）以外の文字の位置または探索対象の文字列の終端へのポインタ
    ACharConstPtr end        // [入力] 探索対象の文字列の終端へのポインタ
);

struct Mailbox {
    SFXAnsiString   name;  // ディスプレイネーム
    SFXAnsiString   addr;  // メールの addr-spec
};