cinap_lenrekadd hg and python4bb9e2215 years agoHistory
55 lines · 1.9 KB · TeX
RawDownload
\section{\module{binhex} ---         Encode and decode binhex4 files} \declaremodule{standard}{binhex}\modulesynopsis{Encode and decode files in binhex4 format.}  This module encodes and decodes files in binhex4 format, a formatallowing representation of Macintosh files in \ASCII.  On the Macintosh,both forks of a file and the finder information are encoded (ordecoded), on other platforms only the data fork is handled. The \module{binhex} module defines the following functions: \begin{funcdesc}{binhex}{input, output}Convert a binary file with filename \var{input} to binhex file\var{output}. The \var{output} parameter can either be a filename or afile-like object (any object supporting a \method{write()} and\method{close()} method).\end{funcdesc} \begin{funcdesc}{hexbin}{input\optional{, output}}Decode a binhex file \var{input}. \var{input} may be a filename or afile-like object supporting \method{read()} and \method{close()} methods.The resulting file is written to a file named \var{output}, unless theargument is omitted in which case the output filename is read from thebinhex file.\end{funcdesc} The following exception is also defined: \begin{excdesc}{Error}Exception raised when something can't be encoded using the binhexformat (for example, a filename is too long to fit in the filenamefield), or when input is not properly encoded binhex data.\end{excdesc}  \begin{seealso}  \seemodule{binascii}{Support module containing \ASCII-to-binary                       and binary-to-\ASCII{} conversions.}\end{seealso}  \subsection{Notes \label{binhex-notes}} There is an alternative, more powerful interface to the coder anddecoder, see the source for details. If you code or decode textfiles on non-Macintosh platforms they willstill use the Macintosh newline convention (carriage-return as end ofline). As of this writing, \function{hexbin()} appears to not work in allcases.