GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Table of Contents
  • binhex — Encode and decode binhex4 files
  • binascii — Convert between binary and ASCII
  • Report a Bug
  • Show Source
  • index
  • modules
  • previous
  • Python
  • 3.10.22 Documentation
  • The Python Standard Library
  • Internet Data Handling

This view

  • Original page
  • New address

GeezerVison is showing docs.python.org — binhex — Encode and decode binhex4 files — Python 3.10.22 documentation

This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

binhex — Encode and decode binhex4 files¶

Source code: Lib/binhex.py

Deprecated since version 3.9.


This module encodes and decodes files in binhex4 format, a format allowing representation of Macintosh files in ASCII. Only the data fork is handled.

The binhex module defines the following functions:

binhex.binhex(input, output)¶

Convert a binary file with filename input to binhex file output. The output parameter can either be a filename or a file-like object (any object supporting a write() and close() method).

binhex.hexbin(input, output)¶

Decode a binhex file input. input may be a filename or a file-like object supporting read() and close() methods. The resulting file is written to a file named output, unless the argument is None in which case the output filename is read from the binhex file.

The following exception is also defined:

exception binhex.Error¶

Exception raised when something can’t be encoded using the binhex format (for example, a filename is too long to fit in the filename field), or when input is not properly encoded binhex data.

See also

Module binascii

Support module containing ASCII-to-binary and binary-to-ASCII conversions.

Notes¶

There is an alternative, more powerful interface to the coder and decoder, see the source for details.

If you code or decode textfiles on non-Macintosh platforms they will still use the old Macintosh newline convention (carriage-return as end of line).

© Copyright 2001-2026, Python Software Foundation.
This page is licensed under the Python Software Foundation License Version 2.
Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.
See History and License for more information.

The Python Software Foundation is a non-profit corporation. Please donate.

Last updated on Oct 11, 2026. Found a bug?
Created using Sphinx 3.4.3.
You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.