diff options
author | Terry Jan Reedy <tjreedy@udel.edu> | 2014-10-01 15:39:05 -0400 |
---|---|---|
committer | Terry Jan Reedy <tjreedy@udel.edu> | 2014-10-01 15:39:05 -0400 |
commit | cf4d6997a3f421a9c5b83dcd92984182a8a5d98f (patch) | |
tree | ed24174d46ff434624503230fa9c0f61f249f9cd | |
parent | f7b2aa514ea6e75d456e7802432b782d8f25cf3f (diff) | |
parent | 1895f2b544379476f23a45c0cfdeb6cec1221c96 (diff) | |
download | cpython-git-cf4d6997a3f421a9c5b83dcd92984182a8a5d98f.tar.gz |
Merge with 3.4
-rw-r--r-- | Doc/library/functions.rst | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index d3b07809fd..3e295d2db1 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1083,8 +1083,8 @@ are always available. They are listed here in alphabetical order. .. function:: print(*objects, sep=' ', end='\\n', file=sys.stdout, flush=False) - Print *objects* to the stream *file*, separated by *sep* and followed by - *end*. *sep*, *end* and *file*, if present, must be given as keyword + Print *objects* to the text stream *file*, separated by *sep* and followed + by *end*. *sep*, *end* and *file*, if present, must be given as keyword arguments. All non-keyword arguments are converted to strings like :func:`str` does and @@ -1094,9 +1094,12 @@ are always available. They are listed here in alphabetical order. *end*. The *file* argument must be an object with a ``write(string)`` method; if it - is not present or ``None``, :data:`sys.stdout` will be used. Whether output - is buffered is usually determined by *file*, but if the *flush* keyword - argument is true, the stream is forcibly flushed. + is not present or ``None``, :data:`sys.stdout` will be used. Since printed + arguments are converted to text strings, :func:`print` cannot be used with + binary mode file objects. For these, use ``file.write(...)`` instead. + + Whether output is buffered is usually determined by *file*, but if the + *flush* keyword argument is true, the stream is forcibly flushed. .. versionchanged:: 3.3 Added the *flush* keyword argument. |