Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

bpo-28393: Update encoding lookup docs wrt bpo-27938 (#4871)

This commit is contained in:
Ville Skyttä 2017-12-15 12:19:23 +02:00 committed by Victor Stinner
parent e425bd7517
commit 297fd876aa
1 changed files with 8 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
Doc/library/codecs.rst
View File

@ -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 Some common encodings can bypass the codecs lookup machinery to
improve performance. These optimization opportunities are only improve performance. These optimization opportunities are only
recognized by CPython for a limited set of aliases: utf-8, utf8, recognized by CPython for a limited set of (case insensitive)
latin-1, latin1, iso-8859-1, mbcs (Windows only), ascii, utf-16, aliases: utf-8, utf8, latin-1, latin1, iso-8859-1, iso8859-1, mbcs
and utf-32. Using alternative spellings for these encodings may (Windows only), ascii, us-ascii, utf-16, utf16, utf-32, utf32, and
result in slower execution. 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 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 characters (e.g. whether the EURO SIGN is supported or not), and in the