\section{\module{binhex} ---
         binhex4 形式ファイルのエンコードおよびデコード}

\declaremodule{standard}{binhex}
\modulesynopsis{binhex4 形式ファイルのエンコードおよびデコード。}

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

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

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

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

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

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


\begin{seealso}
  \seemodule{binascii}{\ASCII からバイナリ、およびバイナリから\ASCII{} 
                       への変換をサポートするモジュール。}
\end{seealso}


\subsection{注記 \label{binhex-notes}}

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

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

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