ilusha/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython synced 2026-09-27 05:14:44 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions

gh-107801: Document io.TextIOWrapper.tell (#108265)

Browse source
This commit is contained in:
Erlend E. Aasland 2023-08-27 22:35:27 +02:00 • committed by GitHub
parent a429eafef2
commit 38afa4af9b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 21 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

10
Doc/library/io.rst
View file

@ -1054,13 +1054,21 @@ Text I/O
* ``seek(0, SEEK_SET)``: Rewind to the start of the stream.
* ``seek(cookie, SEEK_SET)``: Restore a previous position;
*cookie* **must be** a number returned by :meth:`!tell`.
*cookie* **must be** a number returned by :meth:`tell`.
* ``seek(0, SEEK_END)``: Fast-forward to the end of the stream.
* ``seek(0, SEEK_CUR)``: Leave the current stream position unchanged.
Any other argument combinations are invalid,
and may raise exceptions.
.. method:: tell()
Return the stream position as an opaque number.
The return value of :meth:`!tell` can be given as input to :meth:`seek`,
to restore a previous stream position.
.. class:: StringIO(initial_value='', newline='\n')
A text stream using an in-memory text buffer. It inherits

8
Modules/_io/clinic/textio.c.h generated
View file

@ -813,7 +813,11 @@ exit:
PyDoc_STRVAR(_io_TextIOWrapper_tell__doc__,
"tell($self, /)\n"
"--\n"
"\n");
"\n"
"Return the stream position as an opaque number.\n"
"\n"
"The return value of tell() can be given as input to seek(), to restore a\n"
"previous stream position.");
#define _IO_TEXTIOWRAPPER_TELL_METHODDEF \
{"tell", (PyCFunction)_io_TextIOWrapper_tell, METH_NOARGS, _io_TextIOWrapper_tell__doc__},
@ -976,4 +980,4 @@ _io_TextIOWrapper_close(textio *self, PyObject *Py_UNUSED(ignored))
{
return _io_TextIOWrapper_close_impl(self);
}
/*[clinic end generated code: output=c3a8eb2591be1bf7 input=a9049054013a1b77]*/
/*[clinic end generated code: output=390af0e65a0d02c0 input=a9049054013a1b77]*/

7
Modules/_io/textio.c
View file

@ -2640,11 +2640,16 @@ _io_TextIOWrapper_seek_impl(textio *self, PyObject *cookieObj, int whence)
/*[clinic input]
_io.TextIOWrapper.tell
Return the stream position as an opaque number.
The return value of tell() can be given as input to seek(), to restore a
previous stream position.
[clinic start generated code]*/
static PyObject *
_io_TextIOWrapper_tell_impl(textio *self)
/*[clinic end generated code: output=4f168c08bf34ad5f input=9a2caf88c24f9ddf]*/
/*[clinic end generated code: output=4f168c08bf34ad5f input=0852d627d76fb520]*/
{
PyObject *res;
PyObject *posobj = NULL;