Issue #12922: fix the TextIOBase documentation to include a description of seek() and tell() methods.

This commit is contained in:
Antoine Pitrou 2012-01-21 20:27:59 +01:00
parent 51ab3519d8
commit 8fc732f088
1 changed files with 26 additions and 0 deletions

View File

@ -701,6 +701,32 @@ Text I/O
Read until newline or EOF and return a single ``unicode``. If the Read until newline or EOF and return a single ``unicode``. If the
stream is already at EOF, an empty string is returned. stream is already at EOF, an empty string is returned.
.. method:: seek(offset, whence=SEEK_SET)
Change the stream position to the given *offset*. Behaviour depends
on the *whence* parameter:
* :data:`SEEK_SET` or ``0``: seek from the start of the stream
(the default); *offset* must either be a number returned by
:meth:`TextIOBase.tell`, or zero. Any other *offset* value
produces undefined behaviour.
* :data:`SEEK_CUR` or ``1``: "seek" to the current position;
*offset* must be zero, which is a no-operation (all other values
are unsupported).
* :data:`SEEK_END` or ``2``: seek to the end of the stream;
*offset* must be zero (all other values are unsupported).
Return the new absolute position as an opaque number.
.. versionadded:: 2.7
The ``SEEK_*`` constants.
.. method:: tell()
Return the current stream position as an opaque number. The number
does not usually represent a number of bytes in the underlying
binary storage.
.. method:: write(s) .. method:: write(s)
Write the :class:`unicode` string *s* to the stream and return the Write the :class:`unicode` string *s* to the stream and return the