[Python-checkins] bpo-47007: [doc] `str` special method lookup (GH-31863)
JelleZijlstra
webhook-mailer at python.org
Mon Apr 4 22:34:40 EDT 2022
https://github.com/python/cpython/commit/bb86d1d9fbd1888524e04475383f4ea764277f67
commit: bb86d1d9fbd1888524e04475383f4ea764277f67
branch: main
author: Vanshaj Singhania <8797467+itsvs at users.noreply.github.com>
committer: JelleZijlstra <jelle.zijlstra at gmail.com>
date: 2022-04-04T19:34:28-07:00
summary:
bpo-47007: [doc] `str` special method lookup (GH-31863)
Clarify the `str()` docs to point out that `object.__str__()`
follows special method lookup.
Co-authored-by: Jelle Zijlstra <jelle.zijlstra at gmail.com>
files:
M Doc/library/stdtypes.rst
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index cdc4dad067814..6608b7b60ec50 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -1517,7 +1517,8 @@ multiple fragments.
depends on whether *encoding* or *errors* is given, as follows.
If neither *encoding* nor *errors* is given, ``str(object)`` returns
- :meth:`object.__str__() <object.__str__>`, which is the "informal" or nicely
+ :meth:`type(object).__str__(object) <object.__str__>`,
+ which is the "informal" or nicely
printable string representation of *object*. For string objects, this is
the string itself. If *object* does not have a :meth:`~object.__str__`
method, then :func:`str` falls back to returning
More information about the Python-checkins
mailing list