SMTP_Charset

4D Internet Commands v15

SMTP_Charset


SMTP_Charset ( encodeHeaders ; bodyCharset ) -> 戻り値

引数	型	説明
encodeHeaders	整数	-1 = 現在の設定を使用, 0 = 管理しない, 1 = ISO-8859-1またはISO-2022-JPの場合、指定された文字セットを使用して変換、拡張文字をエンコード
bodyCharset	整数	-1 = 現在の設定を使用, 0 = 管理しない, 1= ISO-8859-1またはISO-2022-JPの場合、指定された文字セットを使用して変換
戻り値	整数	エラーコード

説明

SMTP_Charset コマンドは、SMTP_QuickSend や SMTP_Send コマンドでメッセージを送信する際に、拡張文字を含むメッセージをサポートするために自動で変換処理が行われるよう設定します。

SMTP_Charset コマンドは、まずメッセージヘッダと添付ファイル名とボディの変換にSMTP_SetPrefsのbodyCharset引数を適用するかを指定し、次に拡張文字を含むヘッダと本文をRFC#1342で定義された“=?ISO-8859-1?Q?Test=E9?= …”のシンタックスでエンコードするかを指定します。このコマンドはインタープロセススコープを持っていて、このコマンド実行後はあらゆる4Dプロセスで SMTP_QuickSend と SMTP_Sendを使用して送信されるメッセージに影響します。

このコマンドは件名やメールアドレスに拡張文字が含まれる場合に有効です (たとえば“=?ISO-8859-1?Q?Test=E9?= <test@n.net >”のようなアドレスのエンコーディング)。

メッセージヘッダに応じて、エンコーディング( SMTP_SetPrefs bodyType引数によって変化、それ以外は常にBase64(だだし題名ヘッダを除く))は以下のように管理されます:

題名、コメントおよび添付ファイル名: 拡張文字を含む場合、文字列全体がbase64でエンコードされる。
From, To, CC, Bcc, Sender, ReplyTo, InReplyTo:
- 山括弧 (“<”, “>”) に挟まれたテキストはメールアドレスとして認識され、エンコードされません。
- SPC < > ( ) @ , ; : " / ? . = などの特別文字や区切り文字はエンコードされません。
- 特別文字や区切り文字に挟まれた文字列は、拡張文字が含まれていればbase64でエンコードされます。
- アドレスの例:
  someone@somewhereはエンコードされません
  Michele <michele@somewhere>, Micheleのみエンコードされます
他のヘッダーはエンコードされません。

encodeHeadersは、メッセージ送信時のヘッダの変換処理の方法とエンコーディングを指定する引数です。デフォルト値は0です。

-1: 現在の設定を使用
0: 管理しない
1:
- SMTP_SetPrefs bodyType 引数が文字セットをISO-8859-1 or ISO-2022-JPに設定していた場合、ヘッダは指定された文字セットを使用して変換されます。
- その一方で、ヘッダに拡張文字を含んでいる場合、指定された文字セットに関わらず“=? Charset specified by the SMTP_SetPrefs command? Base64 Encoding?Test=E9?= …” (RFC#1342を参照)のシンタックスを使用してエンコードがなされます。
- 例外:題名ヘッダは、必要であればSMTP_SetPrefsコマンドのbodyTypeによって指定されたエンコーディングメソッドを使用してエンコーディングされます。

注: “X_…”で始まる拡張ヘッダはUS ASCIIのみで記述しなければなりません。

bodyCharsetは、メッセージ送信時にメッセージボディの変換とエンコーディングに使用する文字セットを指定する引数です。デフォルト値は0です。

-1: 現在の設定を使用
0: 管理しない
1: SMTP_SetPrefs bodyType引数が文字セットをISO-8859-1あるいはISO-2022-JPに設定している場合、メッセージ本文は指定された文字セットを使用して変換されます。

例題

以下の例では、題名と本文はUTF-8文字セットを使用して変換され、題名は以下のRFC 1342シンタックスを使用してエンコードされます:

 SMTP_SetPrefs(1;1;0)

 $err:=SMTP_Charset(1;1)

 $err:=SMTP_QuickSend("mymail.com";"myaddress";"destination";"the Euro €";"the Euro symbol is €")

参照

POP3_Charset
SMTP_SetPrefs