diff options
| author | Nadeem Vawda <nadeem.vawda@gmail.com> | 2013-12-08 18:47:22 (GMT) |
|---|---|---|
| committer | Nadeem Vawda <nadeem.vawda@gmail.com> | 2013-12-08 18:47:22 (GMT) |
| commit | 6976104a36aa426bcf23b2e4b7e7a706f25beeeb (patch) | |
| tree | aff404b718a6a9fef4d205bf076862d5eee3c20e /Doc | |
| parent | 3e60a9d602c85b738dc74a3c8a196650822e8619 (diff) | |
| download | cpython-6976104a36aa426bcf23b2e4b7e7a706f25beeeb.zip cpython-6976104a36aa426bcf23b2e4b7e7a706f25beeeb.tar.gz cpython-6976104a36aa426bcf23b2e4b7e7a706f25beeeb.tar.bz2 | |
#18430: Document that peek() may change the position of the underlying file for
the BZ2File, GzipFile and LZMAFile classes.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/bz2.rst | 5 | ||||
| -rw-r--r-- | Doc/library/gzip.rst | 5 | ||||
| -rw-r--r-- | Doc/library/lzma.rst | 5 |
3 files changed, 15 insertions, 0 deletions
diff --git a/Doc/library/bz2.rst b/Doc/library/bz2.rst index 95a5abb..b79bccd 100644 --- a/Doc/library/bz2.rst +++ b/Doc/library/bz2.rst @@ -91,6 +91,11 @@ All of the classes in this module may safely be accessed from multiple threads. byte of data will be returned (unless at EOF). The exact number of bytes returned is unspecified. + .. note:: While calling :meth:`peek` does not change the file position of + the :class:`BZ2File`, it may change the position of the underlying file + object (e.g. if the :class:`BZ2File` was constructed by passing a file + object for *filename*). + .. versionadded:: 3.3 .. versionchanged:: 3.1 diff --git a/Doc/library/gzip.rst b/Doc/library/gzip.rst index ec16f6a..354deed 100644 --- a/Doc/library/gzip.rst +++ b/Doc/library/gzip.rst @@ -113,6 +113,11 @@ The module defines the following items: the call. The number of bytes returned may be more or less than requested. + .. note:: While calling :meth:`peek` does not change the file position of + the :class:`GzipFile`, it may change the position of the underlying + file object (e.g. if the :class:`GzipFile` was constructed with the + *fileobj* parameter). + .. versionadded:: 3.2 .. versionchanged:: 3.1 diff --git a/Doc/library/lzma.rst b/Doc/library/lzma.rst index da46575..07b69eb 100644 --- a/Doc/library/lzma.rst +++ b/Doc/library/lzma.rst @@ -98,6 +98,11 @@ Reading and writing compressed files byte of data will be returned, unless EOF has been reached. The exact number of bytes returned is unspecified (the *size* argument is ignored). + .. note:: While calling :meth:`peek` does not change the file position of + the :class:`LZMAFile`, it may change the position of the underlying + file object (e.g. if the :class:`LZMAFile` was constructed by passing a + file object for *filename*). + Compressing and decompressing data in memory -------------------------------------------- |