12.13 `binascii` -- バイナリデータと ASCIIデータとの間での変換

binascii モジュールにはバイナリと ASCIIコード化されたバイナリ表現との間の変換を行うための多数のメソッドが含まれています。通常、これらの関数を直接使う必要はなく、 uu や binhex といった、ラッパ(wrapper) モジュールを使うことになるでしょう。このモジュールが独立して存在するのは、Python において大量のデータに対するビット操作が低速であるという理由からです。

binascii モジュールでは以下の関数を定義します:

a2b_uu( string): uuencode された 1 行のデータをバイナリに変換し、変換後のバイナリデータを返します。最後の行を除いて、通常 1 行には(バイナリデータで) 45 バイトが含まれます。入力データの先頭には空白文字が連続していてもかまいません。

b2a_uu( data): バイナリデータを uuencode して 1 行の ASCII 文字列に変換します。戻り値は変換後の 1 行の文字列で、改行を含みます。data の長さは 45 バイト以下でなければなりません。

a2b_base64( string): base64 でエンコードされたデータのブロックをバイナリに変換し、変換後のバイナリデータを返します。一度に 1 行以上のデータを与えてもかまいません。

b2a_base64( data): バイナリデータを base64 でエンコードして 1 行の ASCII 文字列に変換します。戻り値は変換後の 1 行の文字列で、改行文字を含みます。 base64 標準を遵守するためには、data の長さは 57 バイト以下でなくてはなりません。

a2b_qp( string[, header]): quoted-printable 形式のデータをバイナリに変換し、バイナリデータを返します。一度に 1 行以上のデータを渡すことができます。オプション引数 header が与えられており、かつその値が真であれば、アンダースコアは空白文字にデコードされます。

b2a_qp( data[, quotetabs, istext, header]): バイナリデータを quoted-printable 形式でエンコードして 1 行から複数行の ASCII 文字列に変換します。変換後の文字列を返します。オプション引数 quptetabs が存在し、かつその値が真であれば、全てのタブおよび空白文字もエンコードされます。オプション引数 header が存在し、かつその値が真であれば、空白文字は RFC1522 に従ってアンダースコアにエンコードされます。オプション引数 header が存在し、かつその値が偽である場合、改行文字も同様にエンコードされます。そうでない場合、復帰 (linefeed) 文字の変換によってバイナリデータストリームが破損してしまうかもしれません。

a2b_hqx( string): binhex4 形式の ASCII 文字列データを RLE 展開を行わないでバイナリに変換します。文字列はバイナリのバイトデータを完全に含むような長さか、または (binhex4 データの最後の部分の場合) 余白のビットがゼロになっていなければなりません。

rledecode_hqx( data): data に対し、binhex4 標準に従って RLE 展開を行います。このアルゴリズムでは、あるバイトの後ろに 0x90 がきた場合、そのバイトの反復を指示しており、さらにその後ろに反復カウントが続きます。カウントが 0 の場合 0x90 自体を示します。このルーチンは入力データの末端における反復指定が不完全でないかぎり解凍されたデータを返しますが、不完全な場合、例外 Incomplete が送出されます。

rlecode_hqx( data): binhex4 方式の RLE 圧縮を data に対して行い、その結果を返します。

b2a_hqx( data): バイナリを hexbin4 エンコードして ASCII 文字列に変換し、変換後の文字列を返します。引数の data はすでに RLE エンコードされていなければならず、その長さは (最後のフラグメントを除いて) 3 で割り切れなければなりません。

crc_hqx( data, crc): data の binhex4 CRC 値を計算します。初期値は crc で、計算結果を返します。

crc32( data[, crc])

32 ビットチェックサムである CRC-32 を data に対して計算します。初期値は crc です。これは ZIP ファイルのチェックサムと同じです。このアルゴリズムはチェックサムアルゴリズムとして設計されたもので、一般的なハッシュアルゴリズムには向きません。以下のようにして使います:

    print binascii.crc32("hello world")
    # Or, in two pieces:
    crc = binascii.crc32("hello")
    crc = binascii.crc32(" world", crc)
    print crc

b2a_hex( data)
hexlify( data): バイナリデータ data の16進数表現を返します。data の各バイトは対応する 2 桁の16進数表現に変換されます。従って、変換結果の文字列はdata の 2 倍の長さになります。

a2b_hex( hexstr)
unhexlify( hexstr): 16 進数表記の文字列 hexstr の表すバイナリデータを返します。この関数は b2a_hex() の逆です。hexstr は 16進数字 (大文字でも小文字でもかまいません) を偶数個含んでいなければなりません。そうでないばあい、例外 TypeError が送出されます。

exception Error: エラーが発生した際に送出される例外です。通常はプログラムのエラーです。

exception Incomplete: 変換するデータが不完全な場合に送出される例外です。通常はプログラムのエラーではなく、多少追加読み込みを行って再度変換を試みることで対処できます。

参考:

base64:モジュール: MIME 電子メールメッセージで使われる base64 エンコードのサポート。.

binhex:モジュール: Machintosh で使われる binhex フォーマットのサポート。.

uu:モジュール: Unixで使われる UU エンコードのサポート。.

quopri:モジュール: MIME 電子メールメッセージで使われる quoted-printable エンコードのサポート。.

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。

12.13 binascii -- バイナリデータと ASCIIデータとの間での変換

12.13 `binascii` -- バイナリデータと ASCIIデータとの間での変換