mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-07-23 19:25:40 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 11

rewrite binary std streams part; note that detach()/buffer will not always work

Browse source
This commit is contained in:
Benjamin Peterson 2009-06-14 18:41:18 +00:00
parent 6a38ceda03
commit 995bb47c17
1 changed files with 8 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

11
Doc/library/sys.rst
View file

@ -784,13 +784,18 @@ always available.
The standard streams are in text mode by default. To write or read binary The standard streams are in text mode by default. To write or read binary
data to these, use the underlying binary buffer. For example, to write bytes data to these, use the underlying binary buffer. For example, to write bytes
to :data:`stdout`, use ``sys.stdout.buffer.write(b'abc')``. Using to :data:`stdout`, use ``sys.stdout.buffer.write(b'abc')``. Using
:meth:`io.TextIOBase.detach` streams can be made binary by default. For :meth:`io.TextIOBase.detach` streams can be made binary by default. This
example, this function sets all the standard streams to binary:: function sets :data:`stdin` and :data:`stdout` to binary::
def make_streams_binary(): def make_streams_binary():
sys.stdin = sys.stdin.detach() sys.stdin = sys.stdin.detach()
sys.stdout = sys.stdout.detach() sys.stdout = sys.stdout.detach()
sys.stderr = sys.stderr.detach()
Note that the streams can be replaced with objects (like
:class:`io.StringIO`) that do not support the
:attr:`~io.BufferedIOBase.buffer` attribute or the
:meth:`~io.BufferedIOBase.detach` method and can raise :exc:`AttributeError`
or :exc:`io.UnsupportedOperation`.
.. data:: __stdin__ .. data:: __stdin__