Mention the os.SEEK_* constants

This commit is contained in:
Andrew M. Kuchling 2006-12-21 13:41:46 +00:00
parent a9b9ae4678
commit 3bffd289b9
3 changed files with 13 additions and 9 deletions

View File

@ -90,10 +90,10 @@ performance optimizations previously implemented in the
\begin{methoddesc}[BZ2File]{seek}{offset\optional{, whence}}
Move to new file position. Argument \var{offset} is a byte count. Optional
argument \var{whence} defaults to \code{0} (offset from start of file,
offset should be \code{>= 0}); other values are \code{1} (move relative to
current position, positive or negative), and \code{2} (move relative to end
of file, usually negative, although many platforms allow seeking beyond
argument \var{whence} defaults to \code{os.SEEK_SET} or \code{0} (offset from start of file;
offset should be \code{>= 0}); other values are \code{os.SEEK_CUR} or \code{1} (move relative to
current position; offset can be positive or negative), and \code{os.SEEK_END} or \code{2} (move relative to end
of file; offset is usually negative, although many platforms allow seeking beyond
the end of a file).
Note that seeking of bz2 files is emulated, and depending on the parameters

View File

@ -140,8 +140,9 @@ Memory-mapped file objects support the following methods:
\begin{methoddesc}{seek}{pos\optional{, whence}}
Set the file's current position. \var{whence} argument is optional
and defaults to \code{0} (absolute file positioning); other values
are \code{1} (seek relative to the current position) and \code{2}
and defaults to \code{os.SEEK_SET} or \code{0} (absolute file
positioning); other values are \code{os.SEEK_CUR} or \code{1} (seek
relative to the current position) and \code{os.SEEK_END} or \code{2}
(seek relative to the file's end).
\end{methoddesc}

View File

@ -1678,9 +1678,12 @@ flush the read-ahead buffer.
\begin{methoddesc}[file]{seek}{offset\optional{, whence}}
Set the file's current position, like \code{stdio}'s \cfunction{fseek()}.
The \var{whence} argument is optional and defaults to \code{0}
(absolute file positioning); other values are \code{1} (seek
relative to the current position) and \code{2} (seek relative to the
The \var{whence} argument is optional and defaults to
\code{os.SEEK_SET} or \code{0}
(absolute file positioning); other values are \code{os.SEEK_CUR} or \code{1}
(seek
relative to the current position) and \code{os.SEEK_END} or \code{2}
(seek relative to the
file's end). There is no return value. Note that if the file is
opened for appending (mode \code{'a'} or \code{'a+'}), any
\method{seek()} operations will be undone at the next write. If the