Skip to content

Commit 3305a3f

Browse files
Link instead
1 parent fd1b26e commit 3305a3f

File tree

1 file changed

+2
-43
lines changed

1 file changed

+2
-43
lines changed

Doc/library/functions.rst

Lines changed: 2 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1422,51 +1422,10 @@ are always available. They are listed here in alphabetical order.
14221422

14231423
*errors* is an optional string that specifies how encoding and decoding
14241424
errors are to be handled—this cannot be used in binary mode.
1425-
A variety of standard error handlers are available
1426-
(listed under :ref:`error-handlers`, and summarized below for convenience),
1425+
A variety of standard error handlers are available,
14271426
though any error handling name that has been registered with
14281427
:func:`codecs.register_error` is also valid. The standard names
1429-
include:
1430-
1431-
.. list-table::
1432-
:header-rows: 1
1433-
1434-
* - Error handler
1435-
- Description
1436-
* - ``'strict'``
1437-
- Raise a :exc:`UnicodeError` (or a subclass) exception if there is
1438-
an error. The default value of ``None`` has the same effect.
1439-
* - ``'ignore'``
1440-
- Ignore the malformed data and continue without further notice.
1441-
Note that ignoring encoding errors can lead to data loss.
1442-
* - ``'replace'``
1443-
- Replace malformed data with a replacement marker.
1444-
On writing, use ``?`` (ASCII character 63).
1445-
On reading, use ```` (U+FFFD, the official REPLACEMENT CHARACTER)
1446-
* - ``'backslashreplace'``
1447-
- Replace malformed data with backslashed escape sequences.
1448-
On writing, use hexadecimal form of Unicode code points with formats
1449-
:samp:`\\x{hh}` :samp:`\\u{xxxx}` :samp:`\\U{xxxxxxxx}`.
1450-
On reading, use hexadecimal form of byte value with format :samp:`\\x{hh}`.
1451-
* - ``'surrogateescape'``
1452-
- Will represent any incorrect bytes as low
1453-
surrogate code units ranging from ``U+DC80`` to ``U+DCFF``.
1454-
These surrogate code units will then be turned back into
1455-
the same bytes when the ``'surrogateescape'`` error handler is used
1456-
when writing data. This is useful for processing files in an
1457-
unknown encoding.
1458-
* - ``'surrogatepass'``
1459-
- Only available for Unicode codecs.
1460-
Allow encoding and decoding surrogate code points
1461-
(``U+D800`` - ``U+DFFF``) as normal code points. Otherwise these codecs
1462-
treat the presence of surrogate code points in :class:`str` as an error.
1463-
* - ``'xmlcharrefreplace'``
1464-
- Only supported when writing.
1465-
Characters not supported by the encoding are replaced with the
1466-
appropriate XML character reference :samp:`&#{nnn};`.
1467-
* - ``'namereplace'``
1468-
- Only supported when writing. Replaces unsupported characters with
1469-
``\N{...}`` escape sequences.
1428+
can be found in :ref:`error-handlers`.
14701429

14711430
.. index::
14721431
single: universal newlines; open() built-in function

0 commit comments

Comments
 (0)