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 xuanji
Recipients belopolsky, docs@python, eric.araujo, terry.reedy, xuanji
Date 2010-12-19.14:14:25
SpamBayes Score 3.863021e-13
Marked as misclassified No
Message-id <1292768069.88.0.290792063182.issue10702@psf.upfronthosting.co.za>
In-reply-to
Content
Hi, it seems to me that section 4.6.5. Bytes and Byte Array Methods covers this already. It says:

Bytes and bytearray objects, being “strings of bytes”, have all methods found on strings, with the exception of encode(), format() and isidentifier(), which do not make sense with these types. For converting the objects to strings, they have a decode() method.

Wherever one of these methods needs to interpret the bytes as characters (e.g. the is...() methods), the ASCII character set is assumed.

This section covers belpolsky's needs, ie a reader can, from this, understand that bytes have a capitalize method. However, I support

1) Expanding this section to explain more clearly what the methods do to bytes
2) Discuss unicode vs bytes details
3) Mention bytes and bytearrays in 4.6.1 String Methods, because it is quite far away from 4.6.5

As for the suggestion of renaming, if we rename the section, we have to decide what to call a string/byte/bytearray object because it now says, for example, str.something(); also we have to document the encode and decode methods seperately because they are not common to strings and bytes.
History
Date User Action Args
2010-12-19 14:14:29xuanjisetrecipients: + xuanji, terry.reedy, belopolsky, eric.araujo, docs@python
2010-12-19 14:14:29xuanjisetmessageid: <1292768069.88.0.290792063182.issue10702@psf.upfronthosting.co.za>
2010-12-19 14:14:25xuanjilinkissue10702 messages
2010-12-19 14:14:25xuanjicreate