![]() ![]() ![]()
|
BREW C++ ライブラリ & GUI フレームワーク & XML ミドルウェア : SophiaFramework UNIVERSE 5.0 |
RFC2822 ( Internet Message Format ) に準拠したメッセージのヘッダーを解析するためのパーサー関数と、Base64 や QuotedPrintable、MD5 などの処理をするための関数があります。
メールメッセージ全体の解析に関しては SFXMailMessage クラスを、RFC2047 ( MIME Part Three : Message Header Extensions for Non-ASCII Text ) で定義される MIME エンコードの解析は SFXMailField クラスを使います。
| 型 |
|---|
|
Mailbox メール アドレスを表す構造体です。
|
[ public, static ] SFCError DecodeBase64( ACharConstPtr in // Base64 エンコードされたデータへのポインタ UInt32 size // Base64 エンコードされたデータのサイズ SFXBufferPtr out // 出力バッファへのポインタ );
[ public, static ] SFCError DecodeBase64( SFXBufferConstRef in // Base64 エンコードされたデータへの参照 SFXBufferPtr out // 出力バッファへのポインタ );
[ public, static ] SFCError DecodeBase64( SFXAnsiStringConstRef in // Base64 エンコードされたデータへの参照 SFXAnsiStringPtr out // 出力バッファへのポインタ );
RFC2045 ( MIME Part One : Format of Internet Message Bodies ) で定義される、Base64 形式でエンコードされたデータをデコードします。
BREW ラッパークラスの SFBWebUtil::DecodeBase64 関数との違いは、改行の処理です。
[ public, static ] SFCError DecodeQuotedPrintable( ACharConstPtr in // Quoted-Printable エンコードされたデータへのポインタ UInt32 size // Quoted-Printable エンコードされたデータのサイズ SFXBufferPtr out // 出力バッファへのポインタ Bool text = true // テキスト モード );
[ public, static ] SFCError DecodeQuotedPrintable( SFXBufferConstRef in // Quoted-Printable エンコードされたデータへの参照 SFXBufferPtr out // 出力バッファへのポインタ Bool text = true // テキスト モード );
[ public, static ] SFCError DecodeQuotedPrintable( SFXAnsiStringConstRef in // Quoted-Printable エンコードされたデータへの参照 SFXAnsiStringPtr out // 出力バッファへのポインタ Bool text = true // テキスト モード );
RFC2045 ( MIME Part One : Format of Internet Message Bodies ) で定義される、Quoted-Printable 形式でエンコードされたデータをデコードします。
不正な文字は無効にしてデコードします。
![]() |
注意 |
|---|---|
不正な文字がある場合、戻り値は SFERR_INVALID_FORMAT になりますが、デコードは正常に終了します。 | |
[ public, static ] SFCError EncodeBase64( ACharConstPtr in // Base64 エンコードするデータへのポインタ UInt32 size // Base64 エンコードするデータのサイズ SFXBufferPtr out // 出力バッファへのポインタ UInt32 chars = 64 // 1 行の文字数 SFXAnsiStringConstRef delimiter = "\r\n" // 改行文字列 );
[ public, static ] SFCError EncodeBase64( SFXBufferConstRef in // Base64 エンコードするデータへの参照 SFXBufferPtr out // 出力バッファへのポインタ UInt32 chars = 64 // 1 行の文字数 SFXAnsiStringConstRef delimiter = "\r\n" // 改行文字列 );
[ public, static ] SFCError EncodeBase64( SFXAnsiStringConstRef in // Base64 エンコードするデータへの参照 SFXAnsiStringPtr out // 出力バッファへのポインタ UInt32 chars = 64 // 1 行の文字数 SFXAnsiStringConstRef delimiter = "\r\n" // 改行文字列 );
RFC2045 ( MIME Part One : Format of Internet Message Bodies ) で定義される、Base64 形式でデータをエンコードします。
BREW ラッパークラスの SFBWebUtil::EncodeBase64 関数との違いは、改行の処理です。
[ public, static ] SFCError EncodeQuotedPrintable( ACharConstPtr in // Quoted-Printable エンコードするデータへのポインタ UInt32 size // Quoted-Printable エンコードするデータのサイズ SFXBufferPtr out // 出力バッファへのポインタ UInt32 chars = 64 // 1 行の文字数 Bool text = true // テキスト モードかどうか );
[ public, static ] SFCError EncodeQuotedPrintable( SFXBufferConstRef in // Quoted-Printable エンコードするデータへの参照 SFXBufferPtr out // 出力バッファへのポインタ UInt32 chars = 64 // 1 行の文字数 Bool text = true // テキスト モードかどうか );
[ public, static ] SFCError EncodeQuotedPrintable( SFXAnsiStringConstRef in // Quoted-Printable エンコードするデータへの参照 SFXAnsiStringPtr out // 出力バッファへのポインタ UInt32 chars = 64 // 1 行の文字数 Bool text = true // テキスト モードかどうか );
RFC2045 ( MIME Part One : Format of Internet Message Bodies ) で定義される、Quoted-Printable 形式でデータをエンコードします。
[ public, static ] Bool FindNextBoundary( ACharConstPtr start // 検索開始位置へのポインタ ACharConstPtr end // 検索終了位置へのポインタ SFXAnsiStringConstRef boundary // boundary 文字列 ACharConstHandle found // 見つかった boundary 文字列の位置へのポインタを格納するハンドル ACharConstHandle next // 見つかった boundary 文字列の次の文字へのポインタを格納するハンドル );
検索する MIME ドキュメントの先頭へのポインタです。
検索する MIME ドキュメントの終端へのポインタです。 このポインタが指す文字は、検索対象に含まれません。
検索する boundary 文字列です。
見つかった boundary 文字列の位置( boundary 文字列の前にある CRLF の CR 文字)へのポインタが格納されます。取得する必要がない場合は null を指定します。
見つかった boundary 文字列の後にある最初の CRLF の次の文字、または検索する MIME ドキュメントの終端へのポインタが格納されます。取得する必要がない場合は null を指定します。
終端 ( '--' と boundary 文字列と '--' で構成される文字列 ) ではない boundary 文字列が見つかった場合、true を返します。
boundary の終端 ( '--' と boundary 文字列と '--' で構成される文字列 ) が見つかった場合、false を返します。
boundary の終端 ( '--' と boundary 文字列と '--' で構成される文字列 ) が見つからず、検索する文字列の終端まで到達した場合は false を返します。このとき、found と next は共に end と同じになります。
boundary について : RFC2049 ( MIME Part Five : Conformance Criteria and Examples. Appendix A -- A Complex Multipart Example )
[ 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 // 出力バッファへのポインタ Bool isXdigit // 16 進数で出力するかどうか );
[ public, static ] SFCError GetHMACMD5( SFXBufferConstRef in // 入力データ SFXBufferConstRef key // キーへの参照 SFXBufferPtr out // 出力バッファへのポインタ Bool isXdigit // 16 進数で出力するかどうか );
[ public, static ] SFCError GetHMACMD5( SFXAnsiStringConstRef in // 入力データ SFXAnsiStringConstRef key // キーへの参照 SFXAnsiStringPtr out // 出力文字列へのポインタ Bool isXdigit // 16 進数で出力するかどうか );
[ public, static ] SFCError GetKeyedMD5( VoidConstPtr datagram // 入力データ UInt32 size // 入力データのサイズ SFXBufferConstRef key // キーへの参照 AChar keyfill // パッド SFXBufferPtr out // 出力バッファへのポインタ Bool isXdigit // 16 進数で出力するかどうか );
[ public, static ] SFCError GetKeyedMD5( SFXBufferConstRef datagram // 入力データ SFXBufferConstRef key // キーへの参照 AChar keyfill // パッド SFXBufferPtr out // 出力バッファへのポインタ Bool isXdigit // 16 進数で出力するかどうか );
[ public, static ] SFCError GetKeyedMD5( SFXAnsiStringConstRef datagram // 入力データ SFXAnsiStringConstRef key // キー AChar keyfill // パッド SFXAnsiStringPtr out // 出力文字列へのポインタ Bool isXdigit // 16 進数で出力するかどうか );
[ public, static ] SFCError GetMD5( VoidConstPtr in // 入力データ UInt32 size // 入力データのサイズ SFXBufferPtr out // 出力バッファへのポインタ Bool isXdigit // 16 進数で出力するかどうか );
[ public, static ] SFCError GetMD5( SFXBufferConstRef in // 入力データ SFXBufferPtr out // 出力バッファへのポインタ Bool isXdigit // 16 進数で出力するかどうか );
[ public, static ] SFCError GetMD5( SFXAnsiStringConstRef in // 入力データ SFXAnsiStringPtr out // 出力文字列へのポインタ Bool isXdigit // 16 進数で出力するかどうか );
SFXMailUtility::GetMD5 関数は SFBHash クラスのラッパー関数です。
[ public, static ] SInt16 HexToByte( AChar c1 // 変換する 2 桁の 16 進数の上位桁の文字 AChar c2 // 変換する 2 桁の 16 進数の下位桁の文字 );
変換に成功した場合はその値、失敗した場合は -1 を返します。
例えば、1B( c1 = '1'、c2 = 'B' ) は 27 に変換されます。
例えば、'1' は 1 に、'B' は 11 に、'f' は 15 に変換されます。
判定する文字を指定します。
RFC2822 ( Internet Message Format ) で定義される、atext 文字かどうかを判定します。
atext 文字とは、ヘッダー フィールドの中で atom を構成する英数字と "!"、"#"、"$"、"%"などの記号です。
![]() |
atext について |
|---|---|
SFXMailUtility::IsCTL | SFXMailUtility::IsTokenChar | SFXMailUtility::IsTspecials | SFXMailUtility::IsWSP
判定する文字を指定します。
コントロール文字とは、"0x00" から "0x19" までと "0x7f" の文字です。
SFXMailUtility::IsAtext | SFXMailUtility::IsTokenChar | SFXMailUtility::IsTspecials | SFXMailUtility::IsWSP
判定する文字を指定します。
RFC2045 ( MIME Part One : Format of Internet Message Bodies ) で定義される、トークンを構成する文字かどうかを判定します。
トークンを構成する文字とは、TSPECAIL、スペース、コントロール以外の任意の文字です。
![]() |
トークンを構成する文字について |
|---|---|
詳細情報: RFC2045 (MIME Part One : Format of Internet Message Bodies). | |
SFXMailUtility::IsAtext | SFXMailUtility::IsCTL | SFXMailUtility::IsTspecials | SFXMailUtility::IsWSP
判定する文字を指定します。
RFC2045 ( MIME Part One : Format of Internet Message Bodies ) で定義される、TSPECIAL 文字かどうかを判定します。
TSPECIAL 文字とは、ヘッダー フィールドをデータとして扱う場合、クオート( " )する必要がある記号です。
![]() |
ATSPECIAL 文字について |
|---|---|
詳細情報: RFC2045 (MIME Part One : Format of Internet Message Bodies) | |
SFXMailUtility::IsAtext | SFXMailUtility::IsCTL | SFXMailUtility::IsTokenChar | SFXMailUtility::IsWSP
[ public, static ] Bool IsValidFieldName( ACharConstPtr start // フィールドの先頭へのポインタ ACharConstPtr end = null // フィールドの終端へのポインタ );
フィールドの先頭を指定します。
フィールドの終端を指定します。null を指定した場合は '\0' 文字を終端とします。
判定する文字を指定します。
SFXMailUtility::IsAtext | SFXMailUtility::IsCTL | SFXMailUtility::IsTokenChar | SFXMailUtility::IsTspecials
[ public, static ] SFCError JISToShiftJIS( SFXAnsiStringConstRef in // 変換元の文字列への参照 SFXAnsiStringPtr out // 変換後の文字列へのポインタ AChar unconvChar = '\0' // 変換できない文字の代替文字 );
変換元の文字列です。JIS コード ( iso-2022-jp ) の文字列を指定します。
変換後の文字列です。
変換できない文字に関する代替文字を指定します。引数のデフォルト値は '\0' です。'\0' の場合、代替文字は使われません。
unconvChar 引数を指定した場合、変換できない文字は unconvChar 引数で指定した代替文字で置き換えられ、戻り値は必ず SFERR_NO_ERROR になります。
半角カナもサポートしています。
例えば、1 は '1'、11 は 'B' に変換されます。
[ public, static ] SFCError ParseAddrSpec( ACharConstPtr start // 解析対象文字列の先頭へのポインタ ACharConstPtr end // 解析対象文字列の終端へのポインタ ACharConstHandle next // 解析終了位置へのハンドル SFXAnsiStringPtr value // 解析結果のメール アドレス ( addr-spec ) へのポインタ );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は解析対象に含まれません。
メール アドレス ( addr-spec ) の次の文字へのポインタを格納するハンドルです。 取得する必要がない場合は null を指定します。
解析結果のメール アドレス ( addr-spec ) へのポインタです。 取得する必要がない場合は null を指定します。
文字列を解析して、RFC2822 ( Internet Message Format ) で定義される、メール アドレス ( addr-spec ) として取得します。
From: フィールドや To: フィールドのメール アドレスを解析する場合は、 SFXMailUtility::ParseMailbox 関数や、SFXMailUtility::ParseMailboxList 関数を使う必要があります。
SFXMailUtility::ParseAtom | SFXMailUtility::ParseContentType | SFXMailUtility::ParseDate | SFXMailUtility::ParseDotAtom | SFXMailUtility::ParseDotAtomText | SFXMailUtility::ParseMailbox | SFXMailUtility::ParseMailboxList | SFXMailUtility::ParseParameter | SFXMailUtility::ParseParameterList | SFXMailUtility::ParsePhrase | SFXMailUtility::ParseQuotedString | SFXMailUtility::ParseToken | SFXMailUtility::ParseWord
[ public, static ] SFCError ParseAtom( ACharConstPtr start // 解析対象文字列の先頭へのポインタ ACharConstPtr end // 解析対象文字列の終端へのポインタ ACharConstHandle next // 解析終了位置へのハンドル SFXAnsiStringPtr value // 解析結果の atom へのポインタ );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は、解析対象に含まれません。
atom の次の文字へのポインタを格納するハンドルです。 取得する必要がない場合は null を指定します。
解析結果の atom へのポインタです。 取得する必要がない場合は null を指定します。
文字列を解析して、RFC2822 ( Internet Message Format ) で定義される、atom として取得します。
SFXMailUtility::ParseAddrSpec | SFXMailUtility::ParseContentType | SFXMailUtility::ParseDate | SFXMailUtility::ParseDotAtom | SFXMailUtility::ParseDotAtomText | SFXMailUtility::ParseMailbox | SFXMailUtility::ParseMailboxList | SFXMailUtility::ParseParameter | SFXMailUtility::ParseParameterList | SFXMailUtility::ParsePhrase | SFXMailUtility::ParseQuotedString | SFXMailUtility::ParseToken | SFXMailUtility::ParseWord
[ public, static ] SFCError ParseContentType( SFXAnsiStringConstRef fieldValue // 解析対象文字列 SFXAnsiStringPtr mainType // タイプ SFXAnsiStringPtr subType // サブタイプ SFXPropertyPtr paramList // パラメータ );
解析する文字列です。
解析結果の Content-Type へのポインタです。 取得する必要がない場合は null を指定します。
解析結果の Content-Sub-Type へのポインタです。 取得する必要がない場合は null を指定します。
解析結果のパラメータ リストへのポインタです 取得する必要がない場合は null を指定します。
文字列を解析して、RFC2045 ( MIME Part One : Format of Internet Message Bodies ) で定義される、content-type フィールドのデータとして取得します。
SFXMailUtility::ParseAddrSpec | SFXMailUtility::ParseAtom | SFXMailUtility::ParseDate | SFXMailUtility::ParseDotAtom | SFXMailUtility::ParseDotAtomText | SFXMailUtility::ParseMailbox | SFXMailUtility::ParseMailboxList | SFXMailUtility::ParseParameter | SFXMailUtility::ParseParameterList | SFXMailUtility::ParsePhrase | SFXMailUtility::ParseQuotedString | SFXMailUtility::ParseToken | SFXMailUtility::ParseWord
[ public, static ] SFCError ParseDate( ACharConstPtr start // 解析対象文字列の先頭へのポインタ ACharConstPtr end // 解析対象文字列の終端へのポインタ ACharConstHandle next // 解析終了位置へのハンドル SFXDatePtr date // 日時へのポインタ SInt16Ptr zone // タイムゾーンへのポインタ );
[ public, static ] SFCError ParseDate( SFXAnsiStringConstRef str // 解析対象文字列 SFXDatePtr date // 日時へのポインタ SInt16Ptr zone // タイムゾーンへのポインタ );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は、解析対象に含まれません。
日時をあらわす文字列の後の文字へのポインタを格納するハンドルです。 取得する必要がない場合は null を指定します。
解析結果の日時へのポインタです。 取得する必要がない場合は null を指定します。
解析結果の日時のタイムゾーンへのポインタです。 UTC に対する時差として返されます。 取得する必要がない場合は null を指定します。
解析する文字列です。
文字列を解析して、RFC2822 ( Internet Message Format ) で定義される、日時として取得します。
SFXMailUtility::ParseAddrSpec | SFXMailUtility::ParseAtom | SFXMailUtility::ParseContentType | SFXMailUtility::ParseDotAtom | SFXMailUtility::ParseDotAtomText | SFXMailUtility::ParseMailbox | SFXMailUtility::ParseMailboxList | SFXMailUtility::ParseParameter | SFXMailUtility::ParseParameterList | SFXMailUtility::ParsePhrase | SFXMailUtility::ParseQuotedString | SFXMailUtility::ParseToken | SFXMailUtility::ParseWord
[ public, static ] SFCError ParseDotAtom( ACharConstPtr start // 解析対象文字列の先頭へのポインタ ACharConstPtr end // 解析対象文字列の終端へのポインタ ACharConstHandle next // 解析終了位置へのハンドル SFXAnsiStringPtr value // 解析結果の dot-atom へのポインタ );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は、解析対象に含まれません。
dot-atom の次の文字へのポインタを格納するハンドルです。 取得する必要がない場合は null を指定します。
解析結果の dot-atom へのポインタです。 取得する必要がない場合は null を指定します。
文字列を解析して、RFC2822 ( Internet Message Format ) で定義される、dot-atom として取得します。
dot-atom が dot-atom-text と異なるのは、文字列の先頭と終端に空白を許す点だけです。
SFXMailUtility::ParseDotAtom 関数は、文字列の初めの空白文字を読み飛ばします。
SFXMailUtility::ParseAddrSpec | SFXMailUtility::ParseAtom | SFXMailUtility::ParseContentType | SFXMailUtility::ParseDate | SFXMailUtility::ParseDotAtomText | SFXMailUtility::ParseMailbox | SFXMailUtility::ParseMailboxList | SFXMailUtility::ParseParameter | SFXMailUtility::ParseParameterList | SFXMailUtility::ParsePhrase | SFXMailUtility::ParseQuotedString | SFXMailUtility::ParseToken | SFXMailUtility::ParseWord
[ public, static ] SFCError ParseDotAtomText( ACharConstPtr start // 解析対象文字列の先頭へのポインタ ACharConstPtr end // 解析対象文字列の終端へのポインタ ACharConstHandle next // 解析終了位置へのハンドル SFXAnsiStringPtr value // 解析結果の dot-atom-text へのポインタ );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は、解析対象に含まれません。
dot-atom-text の次の文字へのポインタを格納するハンドルです。 取得する必要がない場合は null を指定します。
解析結果の dot-atom-text へのポインタです。 取得する必要がない場合は null を指定します。
文字列を解析して、RFC2822 ( Internet Message Format ) で定義される、dot-atom-text として取得します。
dot-atom-text とは、atext と ピリオド '.' からなる文字列です。ピリオドは 2 つ続けることや、文字列の先頭や終端に置けません。
SFXMailUtility::ParseDotAtomText 関数は、文字列の初めの空白文字を読み飛ばしません。
文字列の初めが空白文字の場合は SFERR_INVALID_FORMAT を返します。
SFXMailUtility::ParseAddrSpec | SFXMailUtility::ParseAtom | SFXMailUtility::ParseContentType | SFXMailUtility::ParseDate | SFXMailUtility::ParseDotAtom | SFXMailUtility::ParseMailbox | SFXMailUtility::ParseMailboxList | SFXMailUtility::ParseParameter | SFXMailUtility::ParseParameterList | SFXMailUtility::ParsePhrase | SFXMailUtility::ParseQuotedString | SFXMailUtility::ParseToken | SFXMailUtility::ParseWord
[ public, static ] SFCError ParseHeaderLine( ACharConstPtr start // 解析対象文字列の先頭へのポインタ ACharConstPtr end // 解析対象文字列の終端へのポインタ ACharConstHandle next // 解析終了位置へのハンドル SFXAnsiStringPtr value1 // 解析結果のフィールド名へのポインタ SFXAnsiStringPtr value2 // 解析結果のフィールド値へのポインタ );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は、解析対象に含まれません。
次の行へのポインタを格納するハンドルです。 取得する必要がない場合は null を指定します。
解析結果のフィールド名へのポインタです。 取得する必要がない場合は null を指定します。
解析結果のフィールド値へのポインタです。 取得する必要がない場合は null を指定します。
メールメッセージのヘッダーの 1 行を解析して取得します。ヘッダーが複数行に分割されている場合 ( 2 行目以降が WSP から始まる) も正しく取得できます。
[ 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 ) へのポインタ );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は、解析対象に含まれません。
メール アドレスの次の文字へのポインタを格納するハンドルです。 取得する必要がない場合は null を指定します。
解析結果の名前へのポインタです。 取得する必要がない場合は null を指定します。
解析結果のメール アドレスへのポインタです。 取得する必要がない場合は null を指定します。
解析対象文字列です。
文字列を解析して、RFC2822 ( Internet Message Format ) で定義される、メール アドレス ( mailbox ) として取得します。
SFXMailUtility::ParseMailbox 関数は、次の (1)、(2) の addr-spec 形式、(3) の name-addr 形式を解析できます。
my@example.com
my@example.com (My Name)
My Name <my@example.com>
(2)、(3)の場合、ディスプレイネーム( My Name )も取得できます。 SFXMailUtility::ParseMailbox 関数は単一の mailbox しか解析できません。
mailbox のリストを取得する場合は SFXMailUtility::ParseMailboxList 関数を使います。
SFXMailUtility::ParseAddrSpec | SFXMailUtility::ParseAtom | SFXMailUtility::ParseContentType | SFXMailUtility::ParseDate | SFXMailUtility::ParseDotAtom | SFXMailUtility::ParseDotAtomText | SFXMailUtility::ParseMailboxList | SFXMailUtility::ParseParameter | SFXMailUtility::ParseParameterList | SFXMailUtility::ParsePhrase | SFXMailUtility::ParseQuotedString | SFXMailUtility::ParseToken | SFXMailUtility::ParseWord
[ public, static ] SFCError ParseMailboxList( ACharConstPtr start // 解析対象文字列の先頭へのポインタ ACharConstPtr end // 解析対象文字列の終端へのポインタ ACharConstHandle next // 解析終了位置へのハンドル MailboxHandle mailboxes // メール アドレスのリスト SInt32Ptr mbxCount // メールアドレスの数 );
[ public, static ] SFCError ParseMailboxList( SFXAnsiStringConstRef str // 解析対象文字列 MailboxHandle mailboxes // メール アドレスのリストへのポインタを格納するハンドル SInt32Ptr mbxCount // メール アドレスの数 );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は、解析対象に含まれません。
メール アドレスの次の文字へのポインタを格納するハンドルです。 取得する必要がない場合は null を指定します。
解析結果のメール アドレスのリストへのポインタを格納するハンドルです。 SFXMailUtility::Mailbox の配列が渡されます。
配列は、呼び出し側が delete[] で解放する必要があります。 取得する必要がない場合は null を指定します。
解析結果のメール アドレスの数が格納される変数へのポインタです。 取得する必要がない場合は null を指定します。
解析対象の文字列です。
文字列を解析して、RFC2822 ( Internet Message Format ) で定義される、メール アドレス ( mailbox ) のリストとして取得します。
SFXMailUtility::ParseAddrSpec | SFXMailUtility::ParseAtom | SFXMailUtility::ParseContentType | SFXMailUtility::ParseDate | SFXMailUtility::ParseDotAtom | SFXMailUtility::ParseDotAtomText | SFXMailUtility::ParseMailbox | SFXMailUtility::ParseParameter | SFXMailUtility::ParseParameterList | SFXMailUtility::ParsePhrase | SFXMailUtility::ParseQuotedString | SFXMailUtility::ParseToken | SFXMailUtility::ParseWord
[ public, static ] SFCError ParseParameter( ACharConstPtr start // 解析対象文字列の先頭へのポインタ ACharConstPtr end // 解析対象文字列の終端へのポインタ ACharConstHandle next // 解析終了位置へのハンドル SFXAnsiStringPtr name // 属性名へのポインタ SFXAnsiStringPtr value // 値へのポインタ );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は、解析対象に含まれません。
パラメータの次の文字へのポインタを格納するハンドルです。 取得する必要がない場合は null を指定します。
解析結果のパラメータの属性名へのポインタです。 取得する必要がない場合は null を指定します。
解析結果のパラメータの値へのポインタです。 取得する必要がない場合は null を指定します。
文字列を解析して、RFC2045 ( MIME Part One : Format of Internet Message Bodies ) で定義される、attribute = value を表すパラメータとして取得します。
SFXMailUtility::ParseParameter 関数は単一のパラメータしか解析できません。
パラメータのリストを取得する場合は SFXMailUtility::ParseParameterList 関数を使います。
SFXMailUtility::ParseAddrSpec | SFXMailUtility::ParseAtom | SFXMailUtility::ParseContentType | SFXMailUtility::ParseDate | SFXMailUtility::ParseDotAtom | SFXMailUtility::ParseDotAtomText | SFXMailUtility::ParseMailbox | SFXMailUtility::ParseMailboxList | SFXMailUtility::ParseParameterList | SFXMailUtility::ParsePhrase | SFXMailUtility::ParseQuotedString | SFXMailUtility::ParseToken | SFXMailUtility::ParseWord
[ public, static ] SFCError ParseParameterList( ACharConstPtr start // 解析対象文字列の先頭へのポインタ ACharConstPtr end // 解析対象文字列の終端へのポインタ SFXPropertyPtr paramList // 解析結果 );
解析する文字列の先頭へのポインタです。
解析する文字列の終端へのポインタです。 このアドレスが指し示す文字自体は、解析対象に含まれません。
解析結果のパラメータのリストへのポインタです。 取得する必要がない場合は null を指定します。
文字列を解析して、RFC2045 ( MIME Part One : Format of Internet Message Bodies ) で定義される、attr1 = value2 , attr2 = value2 を表すパラメータのリストとして取得します。