Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Note regarding + mode truncation applies to both text and binary mode (#11314) 

* Improve doc on open's mode +

* Improve wording

* Address comment from Rémi
This commit is contained in:
Andre Delfino 2019-09-10 10:04:22 -03:00 committed by Dino Viehland
parent b7f8e52433
commit c1d8c1cb8e
1 changed files with 3 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Doc/library/functions.rst
View File

@ -1070,12 +1070,12 @@ are always available. They are listed here in alphabetical order.
``'a'`` open for writing, appending to the end of the file if it exists
``'b'`` binary mode
``'t'`` text mode (default)
``'+'`` open a disk file for updating (reading and writing)
``'+'`` open for updating (reading and writing)
========= ===============================================================
The default mode is ``'r'`` (open for reading text, synonym of ``'rt'``).
For binary read-write access, the mode ``'w+b'`` opens and truncates the file
to 0 bytes. ``'r+b'`` opens the file without truncation.
Modes ``'w+'`` and ``'w+b'`` opens and truncates the file. Modes ``'r+'``
and ``'r+b'`` opens the file with no truncation.
As mentioned in the :ref:`io-overview`, Python distinguishes between binary
and text I/O. Files opened in binary mode (including ``'b'`` in the *mode*