From 664091be72c8b1620cea239bf8ae0be19570709d Mon Sep 17 00:00:00 2001 From: Antoine Pitrou Date: Sat, 23 Jul 2011 22:00:03 +0200 Subject: Followup to c3b47cdea0d1: document the *write_through* argument to TextIOWrapper. --- Doc/library/io.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Doc/library/io.rst b/Doc/library/io.rst index 0d87305..a76b757 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -706,7 +706,8 @@ Text I/O written. -.. class:: TextIOWrapper(buffer, encoding=None, errors=None, newline=None, line_buffering=False) +.. class:: TextIOWrapper(buffer, encoding=None, errors=None, newline=None, \ + line_buffering=False, write_through=False) A buffered text stream over a :class:`BufferedIOBase` binary stream. It inherits :class:`TextIOBase`. @@ -737,6 +738,13 @@ Text I/O If *line_buffering* is ``True``, :meth:`flush` is implied when a call to write contains a newline character. + If *write_through* is ``True``, calls to :meth:`write` are guaranteed + not to be buffered: any data written on the :class:`TextIOWrapper` + object is immediately handled to its underlying binary *buffer*. + + .. versionchanged:: 3.3 + The *write_through* argument has been added. + :class:`TextIOWrapper` provides one attribute in addition to those of :class:`TextIOBase` and its parents: -- cgit v0.12