This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author kcirtsew
Recipients docs@python, kcirtsew
Date 2020-02-07.01:07:08
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1581037628.78.0.57098348034.issue39574@roundup.psfhosted.org>
In-reply-to
Content
The docstring for the str() builtin reads

str(object='') -> str
str(bytes_or_buffer[, encoding[, errors]]) -> str

Create a new string object from the given object. If encoding or
errors is specified, then the object must expose a data buffer
that will be decoded using the given encoding and error handler.
Otherwise, returns the result of object.__str__() (if defined)
or repr(object).
encoding defaults to sys.getdefaultencoding().
errors defaults to 'strict'.

The statement "encoding defaults to sys.getdefaultencoding()." implies that the encoding argument defaults to sys.getdefaultencoding(), which would typically mean that 

str(X, encoding=sys.getdefaultencoding()) == str(X)

However, this is not the case

str(b'mystring', encoding=sys.getdefaultencoding()) -> 'mystring'
str(b'mystring') -> "b'mystring'"

It seems that the phrase "encoding defaults" is not referring to the argument named encoding.
History
Date User Action Args
2020-02-07 01:07:08kcirtsewsetrecipients: + kcirtsew, docs@python
2020-02-07 01:07:08kcirtsewsetmessageid: <1581037628.78.0.57098348034.issue39574@roundup.psfhosted.org>
2020-02-07 01:07:08kcirtsewlinkissue39574 messages
2020-02-07 01:07:08kcirtsewcreate