From: Martin Panter Date: Sat, 15 Oct 2016 00:56:47 +0000 (+0000) Subject: Issue #23231: Document codecs.iterencode(), iterdecode() shortcomings X-Git-Tag: v3.6.0b3~120^2 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c73e9d844fcc9e91eff5ff933336aa46005bdefc;p=thirdparty%2FPython%2Fcpython.git Issue #23231: Document codecs.iterencode(), iterdecode() shortcomings --- diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst index 1add30072f45..03f022847691 100644 --- a/Doc/library/codecs.rst +++ b/Doc/library/codecs.rst @@ -224,6 +224,10 @@ wider range of codecs when working with binary files: The *errors* argument (as well as any other keyword argument) is passed through to the incremental encoder. + This function requires that the codec accept text :class:`str` objects + to encode. Therefore it does not support bytes-to-bytes encoders such as + ``base64_codec``. + .. function:: iterdecode(iterator, encoding, errors='strict', **kwargs) @@ -232,6 +236,11 @@ wider range of codecs when working with binary files: The *errors* argument (as well as any other keyword argument) is passed through to the incremental decoder. + This function requires that the codec accept :class:`bytes` objects + to decode. Therefore it does not support text-to-text encoders such as + ``rot_13``, although ``rot_13`` may be used equivalently with + :func:`iterencode`. + The module also provides the following constants which are useful for reading and writing to platform dependent files: