18.13. "binhex" --- binhex4 形式ファイルのエンコードおよびデコード
******************************************************************

このモジュールは binhex4 形式のファイルに対するエンコードやデコードを
行います。 binhex4 は Macintosh のファイルを ASCII で表現できるように
したものです。 Macintosh 上では、ファイルと finder 情報の両方のフォー
クがエンコード ( またはデコード ) されます。他のプラットフォームではデ
ータフォークだけが処理されます。

注釈: Python 3.x で特別な Macintosh サポートは削除されました。

"binhex" モジュールでは以下の関数を定義しています:

binhex.binhex(input, output)

   ファイル名 *input* のバイナリファイルをファイル名 *output* の
   binhex 形式ファイルに変換します。 *output* パラメタはファイル名でも
   ("write()" および "close()" メソッドをサポートするような) ファイル
   様オブジェクトでもかまいません。

binhex.hexbin(input[, output])

   binhex 形式のファイル *input* をデコードします。 *input* はファイル
   名でも、 "write()" および "close()" メソッドをサポートするようなフ
   ァイル様オブジェクトでもかまいません。変換結果のファイルはファイル
   名 *output* になります。この引数が省略された場合、出力ファイルは
   binhex ファイルの中から復元されます。

以下の例外も定義されています:

exception binhex.Error

   binhex 形式を使ってエンコードできなかった場合 (例えば、ファイル名が
   filename フィールドに収まらないくらい長かった場合など) や、入力が正
   しくエンコードされた binhex 形式のデータでなかった場合に送出される
   例外です。

参考:

  モジュール "binascii"
     ASCII からバイナリへ、バイナリから ASCII への変換をサポートするモ
     ジュール。


18.13.1. 注釈
=============

別のより強力なエンコーダおよびデコーダへのインタフェースが存在します。
詳しくはソースを参照してください。

非 Macintosh プラットフォームでテキストファイルをエンコードしたりデコ
ードしたりする場合でも、古い Macintosh の改行文字変換 (行末をキヤリッ
ジリターンとする) が行われます。

このドキュメントを書いている時点では、 "hexbin()" はいつも正しく動作す
るわけではないようです。
