Clarify the + and b mode characters for open() a bit.

This commit is contained in:
Guido van Rossum 1998-07-29 21:05:35 +00:00
parent b35631587b
commit 5fdd119aba
1 changed files with 8 additions and 6 deletions

View File

@ -392,12 +392,14 @@ any kind of sequence; the result is always a list.
\code{'a'} opens it for appending (which on \emph{some} \UNIX{} \code{'a'} opens it for appending (which on \emph{some} \UNIX{}
systems means that \emph{all} writes append to the end of the file, systems means that \emph{all} writes append to the end of the file,
regardless of the current seek position). regardless of the current seek position).
Modes \code{'r+'}, \code{'w+'} and
\code{'a+'} open the file for updating, provided the underlying Modes \code{'r+'}, \code{'w+'} and \code{'a+'} open the file for
\code{stdio} library understands this. On systems that differentiate updating (note that \code{'w+'} truncates the file). Append
between binary and text files, \code{'b'} appended to the mode opens \code{'b'} to the mode to open the file in binary mode, on systems
the file in binary mode. If the file cannot be opened, that differentiate between binary and text files (else it is
\exception{IOError} is raised. ignored). If the file cannot be opened, \exception{IOError} is
raised.
If \var{mode} is omitted, it defaults to \code{'r'}. If \var{mode} is omitted, it defaults to \code{'r'}.
The optional \var{bufsize} argument specifies the file's desired The optional \var{bufsize} argument specifies the file's desired
buffer size: 0 means unbuffered, 1 means line buffered, any other buffer size: 0 means unbuffered, 1 means line buffered, any other