Skip to content

C
cpython
Dal (branch)/etiket değiştir
Dosya bul
BlameHistoryPermalink
email.charset.rst 8.84 KB

:mod:`email.charset`: Representing character sets

This module provides a class :class:`Charset` for representing character sets and character set conversions in email messages, as well as a character set registry and several convenience methods for manipulating this registry. Instances of :class:`Charset` are used in several other modules within the :mod:`email` package.

Import this class from the :mod:`email.charset` module.

Map character sets to their email properties.

This class provides information about the requirements imposed on email for a specific character set. It also provides convenience routines for converting between character sets, given the availability of the applicable codecs. Given a character set, it will do its best to provide information on how to use that character set in an email message in an RFC-compliant way.

Certain character sets must be encoded with quoted-printable or base64 when used in email headers or bodies. Certain character sets must be converted outright, and are not allowed in email.

Optional input_charset is as described below; it is always coerced to lower case. After being alias normalized it is also used as a lookup into the registry of character sets to find out the header encoding, body encoding, and output conversion codec to be used for the character set. For example, if input_charset is iso-8859-1, then headers and bodies will be encoded using quoted-printable and no output conversion codec is necessary. If input_charset is euc-jp, then headers will be encoded with base64, bodies will not be encoded, but output text will be converted from the euc-jp character set to the iso-2022-jp character set.

:class:`Charset` instances have the following data attributes:

:class:`Charset` instances also have the following methods:

The :class:`Charset` class also provides a number of methods to support standard operations and built-in functions.

The :mod:`email.charset` module also provides the following functions for adding new entries to the global character set, alias, and codec registries: