次へ: チェックサム/ハッシュ, 前へ: 圧縮データの扱い, 上へ: テキスト   [目次][索引]

33.25 Base 64 エンコーディング ¶

Base 64コードは、電子メールにおいて8ビットバイトのシーケンスを、より長いASCIIグラフィック文字のシーケンスとしてエンコードするために使用されます。このコードは、Internet RFC²⁷2045およびRFC 4648で定義されています。本節では、このコードへの変換およびコードからの変換を行う関数について説明します。

コマンド: base64-encode-region beg end &optional no-line-break ¶

この関数は、begからendまでの領域をBase64コードに変換します。また、エンコードされたテキストの長さを返します。領域内の文字がマルチバイトである場合はエラーが通知されます。つまり、マルチバイトバッファの場合、領域にはASCII文字または生バイトのみが含まれている必要があります。

通常、この関数は行が長くなりすぎるのを防ぐため、エンコード済みテキストに改行文字を挿入します。ただし、オプション引数 no-line-break が nil 以外の場合、これらの改行は追加されないため、出力は1つの長い行になります。

コマンド: base64url-encode-region beg end &optional no-pad ¶

この関数はbase64-encode-regionに似ていますが、RFC 4648に準拠したBase64エンコーディングのURLバリアントを実装しており、エンコード後のテキストに改行文字を挿入しないため、出力は1つの長い行になります。

オプション引数 no-pad が nil 以外の場合、この関数はパディング (=) を生成しません。

関数: base64-encode-string string &optional no-line-break ¶

この関数は、文字列 string を Base64 コードに変換します。エンコードされたテキストを含む文字列を返します。base64-encode-region については、文字列内の文字がマルチバイトである場合にエラーが通知されます。

通常、この関数は行が長くなりすぎるのを防ぐため、エンコード済みテキストに改行文字を挿入します。ただし、オプション引数 no-line-break が nil 以外の場合、これらの改行は追加されないため、結果の文字列は1つの長い行になります。

関数: base64url-encode-string string &optional no-pad ¶

base64-encode-stringと同様ですが、base 64のURLバリアントを生成し、エンコード済みテキストに改行文字を挿入しないため、結果は1つの長い行になります。

オプション引数 no-pad が nil 以外の場合、この関数はパディングを生成しません。

コマンド: base64-decode-region beg end &optional base64url ignore-invalid ¶

この関数は、base 64 コードで表された領域を beg から end に変換し、対応するデコード済みテキストを返します。また、デコード済みテキストの長さを返します。

デコード関数は、エンコード済みテキスト内の改行文字を無視します。

オプション引数 base64url が nil 以外の場合、パディングは任意となり、base 64 エンコーディングの URL 形式が使用されます。オプション引数 ignore-invalid が nil 以外の場合、認識されない文字はすべて無視されます。

関数: base64-decode-string string &optional base64url ignore-invalid ¶

この関数は、base 64 コードの文字列 string を対応するデコード済みテキストに変換します。デコード済みテキストを含むユニバイト文字列を返します。

デコード関数は、エンコード済みテキスト内の改行文字を無視します。

オプション引数 base64url が nil 以外の場合、パディングは任意となり、base 64 エンコーディングの URL 形式が使用されます。オプション引数 ignore-invalid が nil 以外の場合、認識されない文字はすべて無視されます。