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

#2131: note that codecs.open() always opens files in binary mode.

This commit is contained in:
Georg Brandl 2008-02-17 11:33:38 +00:00
parent f9db8a3a20
commit 5e203f56db
1 changed files with 9 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Doc/library/codecs.rst
View File

@ -206,7 +206,8 @@ utility functions:
.. function:: open(filename, mode[, encoding[, errors[, buffering]]])
Open an encoded file using the given *mode* and return a wrapped version
providing transparent encoding/decoding.
providing transparent encoding/decoding. The default file mode is ``'r'``
meaning to open the file in read mode.
.. note::
@ -214,6 +215,13 @@ utility functions:
i.e. Unicode objects for most built-in codecs. Output is also codec-dependent
and will usually be Unicode as well.
.. note::
Files are always opened in binary mode, even if no binary mode was
specified. This is done to avoid data loss due to encodings using 8-bit
values. This means that no automatic conversion of ``'\n'`` is done
on reading and writing.
*encoding* specifies the encoding which is to be used for the file.
*errors* may be given to define the error handling. It defaults to ``'strict'``