@@ -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