From: Benjamin Peterson Date: Sun, 7 Dec 2008 14:58:03 +0000 (+0000) Subject: document how to deal with binary standard streams X-Git-Tag: v3.1a1~733 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=eb9fc524a8a0fa9d60e1bc5b74174b18e08fd008;p=python document how to deal with binary standard streams --- diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index e4dbf177eb..e87b7e1f1f 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -709,6 +709,12 @@ always available. :func:`os.popen`, :func:`os.system` or the :func:`exec\*` family of functions in the :mod:`os` module.) + .. note:: + + The standard streams are text in text mode by default. To write or read + binary data to these, use the underlying binary buffer. For example, to + write bytes to :data:`stdout`, use ``sys.stdout.buffer.write(b'abc')``. + .. data:: __stdin__ __stdout__