[Python-checkins] Note regarding + mode truncation applies to both text and binary mode (#11314)
Dino Viehland
webhook-mailer at python.org
Tue Sep 10 09:04:26 EDT 2019
https://github.com/python/cpython/commit/c1d8c1cb8e90a54a3daaa7fcdb8d6ca7f08d6a73
commit: c1d8c1cb8e90a54a3daaa7fcdb8d6ca7f08d6a73
branch: master
author: Andre Delfino <adelfino at gmail.com>
committer: Dino Viehland <dinoviehland at gmail.com>
date: 2019-09-10T14:04:22+01:00
summary:
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
files:
M Doc/library/functions.rst
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index ce026ebb4b0f..98a55c61eff2 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -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*
More information about the Python-checkins
mailing list