diff options
author | Georg Brandl <georg@python.org> | 2008-06-11 18:37:52 +0000 |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2008-06-11 18:37:52 +0000 |
commit | 3e4813394e9f96c08604ac16b15cca199f869480 (patch) | |
tree | 8664141a6b941dd5c7789bf6d63b9bb5f7f824c0 /Doc/c-api/object.rst | |
parent | a7746fb3fa5cec034d5944c3e7e03727b916f048 (diff) | |
download | cpython-3e4813394e9f96c08604ac16b15cca199f869480.tar.gz |
#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 c9c4a42ba5..f377c751ec 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) |