mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-02 16:13:13 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

Add missing documentation for bytes.decode().

Browse source
This commit is contained in:
Georg Brandl 2009-05-04 21:01:20 +00:00
parent 5f25972a05
commit 4f5f98d7d1
2 changed files with 21 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

2
Doc/howto/unicode.rst
View file

@ -234,7 +234,7 @@ The String Type
Since Python 3.0, the language features a ``str`` type that contain Unicode Since Python 3.0, the language features a ``str`` type that contain Unicode
characters, meaning any string created using ``"unicode rocks!"``, ``'unicode characters, meaning any string created using ``"unicode rocks!"``, ``'unicode
rocks!``, or the triple-quoted string syntax is stored as Unicode. rocks!'``, or the triple-quoted string syntax is stored as Unicode.
To insert a Unicode character that is not part ASCII, e.g., any letters with To insert a Unicode character that is not part ASCII, e.g., any letters with
accents, one can use escape sequences in their string literals as such:: accents, one can use escape sequences in their string literals as such::

28
Doc/library/stdtypes.rst
View file

@ -800,14 +800,14 @@ functions based on regular expressions.
.. method:: str.encode([encoding[, errors]]) .. method:: str.encode([encoding[, errors]])
Return an encoded version of the string. Default encoding is the current Return an encoded version of the string as a bytes object. Default encoding
default string encoding. *errors* may be given to set a different error is the current default string encoding. *errors* may be given to set a
handling scheme. The default for *errors* is ``'strict'``, meaning that different error handling scheme. The default for *errors* is ``'strict'``,
encoding errors raise a :exc:`UnicodeError`. Other possible values are meaning that encoding errors raise a :exc:`UnicodeError`. Other possible
``'ignore'``, ``'replace'``, ``'xmlcharrefreplace'``, ``'backslashreplace'`` and values are ``'ignore'``, ``'replace'``, ``'xmlcharrefreplace'``,
any other name registered via :func:`codecs.register_error`, see section ``'backslashreplace'`` and any other name registered via
:ref:`codec-base-classes`. For a list of possible encodings, see section :func:`codecs.register_error`, see section :ref:`codec-base-classes`. For a
:ref:`standard-encodings`. list of possible encodings, see section :ref:`standard-encodings`.
.. method:: str.endswith(suffix[, start[, end]]) .. method:: str.endswith(suffix[, start[, end]])
@ -1512,6 +1512,18 @@ Wherever one of these methods needs to interpret the bytes as characters
b = a.replace(b"a", b"f") b = a.replace(b"a", b"f")
.. method:: bytes.decode([encoding[, errors]])
bytearray.decode([encoding[, errors]])
Return a string decoded from the given bytes. Default encoding is the
current default string encoding. *errors* may be given to set a different
error handling scheme. The default for *errors* is ``'strict'``, meaning
that encoding errors raise a :exc:`UnicodeError`. Other possible values are
``'ignore'``, ``'replace'`` and any other name registered via
:func:`codecs.register_error`, see section :ref:`codec-base-classes`. For a
list of possible encodings, see section :ref:`standard-encodings`.
The bytes and bytearray types have an additional class method: The bytes and bytearray types have an additional class method:
.. classmethod:: bytes.fromhex(string) .. classmethod:: bytes.fromhex(string)