From 8ae06766cb91064dbda1b80d56a6504c8d6c3037 Mon Sep 17 00:00:00 2001 From: Andre Delfino Date: Tue, 10 Sep 2019 10:04:22 -0300 Subject: [PATCH] Note regarding + mode truncation applies to both text and binary mode (GH-11314) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Improve doc on open's mode + * Improve wording * Address comment from Rémi (cherry picked from commit c1d8c1cb8e90a54a3daaa7fcdb8d6ca7f08d6a73) Co-authored-by: Andre Delfino --- Doc/library/functions.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index c748b086d8acae..a4097b0b30eca2 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1068,12 +1068,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*