Skip to content

Commit

Permalink
bpo-28393: Update encoding lookup docs wrt bpo-27938 (GH-4871) (#4881)
Browse files Browse the repository at this point in the history
(cherry picked from commit 297fd87)
  • Loading branch information
miss-islington authored and vstinner committed Dec 15, 2017
1 parent b580f4f commit 77bf6da
Showing 1 changed file with 8 additions and 4 deletions.
12 changes: 8 additions & 4 deletions Doc/library/codecs.rst
Expand Up @@ -977,10 +977,14 @@ e.g. ``'utf-8'`` is a valid alias for the ``'utf_8'`` codec.

Some common encodings can bypass the codecs lookup machinery to
improve performance. These optimization opportunities are only
recognized by CPython for a limited set of aliases: utf-8, utf8,
latin-1, latin1, iso-8859-1, mbcs (Windows only), ascii, utf-16,
and utf-32. Using alternative spellings for these encodings may
result in slower execution.
recognized by CPython for a limited set of (case insensitive)
aliases: utf-8, utf8, latin-1, latin1, iso-8859-1, iso8859-1, mbcs
(Windows only), ascii, us-ascii, utf-16, utf16, utf-32, utf32, and
the same using underscores instead of dashes. Using alternative
aliases for these encodings may result in slower execution.

.. versionchanged:: 3.6
Optimization opportunity recognized for us-ascii.

Many of the character sets support the same languages. They vary in individual
characters (e.g. whether the EURO SIGN is supported or not), and in the
Expand Down

0 comments on commit 77bf6da

Please sign in to comment.