Quoted-printableエンコーディング (Gauche ユーザリファレンス)

Module: rfc.quoted-printable ¶: このモジュールでは、RFC 2045 (https://www.ietf.org/rfc/rfc2045.txt) のセクション6.7で定義されている、Quoted-printableフォーマットにエンコード/からデコードするためのいくつかの関数を定義しています。

Function: quoted-printable-encode :key line-width binary ¶: {rfc.quoted-printable} 現在の入力ポートからバイトストリームを読み込み、それをQuoted-printable フォーマットにエンコードし、現在の出力ポートへ結果の文字ストリームを書き出します。この変換は、現在の入力ポートからEOFを読み出すと終了します。キーワード引数line-widthは、出力に現れる行の最大長を指定します。エンコードされた行の長さがこの値を越えそうな場合は、「ソフトラインブレーク」が適宜挿入され、各行の長さがこの値を越えないように調整されます。ソフトラインブレークはquoted-printableフォーマットのデコード時に取り除かれます。 line-widthのデフォルト値は76です。(最小の意味のある値は4です。) line-widthに#fまたは0を渡せば、ソフトラインブレークは挿入されません。デフォルトでは、quoted-printable-encodeは入力中の改行に対して CR-LFシーケンスを出力します(「ハードラインブレーク」)。しかし、binaryキーワード引数に真の値が与えられた場合、入力中のオクテット#x0aおよび#x0dはそれぞれ =0A、=0Dのようにエンコードされます。詳しくはRFC2045の6.7節を参照してください。

Function: quoted-printable-encode-message message :key line-width binary ¶

{rfc.quoted-printable} 文字列かu8vectorのmessageの内容をQuoted-printableエンコードして、結果を文字列で返します。

キーワード引数の意味はquoted-printable-encodeと同じです。

Function: quoted-printable-decode ¶: {rfc.quoted-printable} 現在の入力ポートから文字ストリームを読み込み、それをQuoted-printable フォーマットからデコードし、結果のバイトストリームを現在の出力ポートへ書き出します。この変換は、EOFを読み出すと終了します。不正なシーケンス(’=’の後に16進文字が続かない、など)に出会うと、それらをリテラルのまま出力へコピーします。

Function: quoted-printable-decode-string-to target string ¶: {rfc.quoted-printable} Quoted-printableエンコードされた文字列stringをデコードし、その結果をtargetのインスタンスで返します。 targetは<string>か<u8vector>でなければなりません。

Function: quoted-printable-encode-string string :key line-width binary ¶: {rfc.quoted-printable} Deprecated. これは互換性のために残してある手続きです。 quoted-printable-encode-messageを使うようにしてください。

Function: quoted-printable-decode-string string ¶: {rfc.quoted-printable} Deprecated. これは互換性のために残してある手続きです。 (quoted-printable-decode-string-to <string> string)と同じです。