diff options
| author | Georg Brandl <georg@python.org> | 2008-06-11 18:37:52 (GMT) |
|---|---|---|
| committer | Georg Brandl <georg@python.org> | 2008-06-11 18:37:52 (GMT) |
| commit | 559e5d7f4d1155e95fb6f925c927a263f9196935 (patch) | |
| tree | 4688423e81e9ffed7a5b2c87c50b55419e8e885a /Doc/c-api/object.rst | |
| parent | ea6d58d9d3033436b52e84960b9571525a4f5412 (diff) | |
| download | cpython-559e5d7f4d1155e95fb6f925c927a263f9196935.zip cpython-559e5d7f4d1155e95fb6f925c927a263f9196935.tar.gz cpython-559e5d7f4d1155e95fb6f925c927a263f9196935.tar.bz2 | |
#2630: Implement PEP 3138.
The repr() of a string now contains printable Unicode characters unescaped.
The new ascii() builtin can be used to get a repr() with only ASCII characters in it.
PEP and patch were written by Atsuo Ishimoto.
Diffstat (limited to 'Doc/c-api/object.rst')
| -rw-r--r-- | Doc/c-api/object.rst | 14 |
1 files changed, 12 insertions, 2 deletions
diff --git a/Doc/c-api/object.rst b/Doc/c-api/object.rst index c9c4a42..f377c75 100644 --- a/Doc/c-api/object.rst +++ b/Doc/c-api/object.rst @@ -116,8 +116,18 @@ Object Protocol Compute a string representation of object *o*. Returns the string representation on success, *NULL* on failure. This is the equivalent of the - Python expression ``repr(o)``. Called by the :func:`repr` built-in function and - by reverse quotes. + Python expression ``repr(o)``. Called by the :func:`repr` built-in function. + + +.. cfunction:: PyObject* PyObject_ASCII(PyObject *o) + + .. index:: builtin: ascii + + As :cfunc:`PyObject_Repr`, compute a string representation of object *o*, but + escape the non-ASCII characters in the string returned by + :cfunc:`PyObject_Repr` with ``\x``, ``\u`` or ``\U`` escapes. This generates + a string similar to that returned by :cfunc:`PyObject_Repr` in Python 2. + Called by the :func:`ascii` built-in function. .. cfunction:: PyObject* PyObject_Str(PyObject *o) |