mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-21 06:02:21 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

Issue #21859: Corrected FileIO docstrings.

Browse source
This commit is contained in:
Serhiy Storchaka 2015-04-10 16:09:13 +03:00
commit cd092efb16
1 changed files with 18 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

33
Modules/_io/fileio.c
View file

@ -233,7 +233,7 @@ fileio_init(PyObject *oself, PyObject *args, PyObject *kwds)
if (fd < 0) { if (fd < 0) {
if (!PyErr_Occurred()) { if (!PyErr_Occurred()) {
PyErr_SetString(PyExc_ValueError, PyErr_SetString(PyExc_ValueError,
"Negative filedescriptor"); "negative file descriptor");
return -1; return -1;
} }
PyErr_Clear(); PyErr_Clear();
@ -1014,10 +1014,10 @@ fileio_getstate(fileio *self)
PyDoc_STRVAR(fileio_doc, PyDoc_STRVAR(fileio_doc,
"file(name: str[, mode: str][, opener: None]) -> file IO object\n" "file(name: str[, mode: str][, opener: None]) -> file IO object\n"
"\n" "\n"
"Open a file. The mode can be 'r', 'w', 'x' or 'a' for reading (default),\n" "Open a file. The mode can be 'r' (default), 'w', 'x' or 'a' for reading,\n"
"writing, exclusive creation or appending. The file will be created if it\n" "writing, exclusive creation or appending. The file will be created if it\n"
"doesn't exist when opened for writing or appending; it will be truncated\n" "doesn't exist when opened for writing or appending; it will be truncated\n"
"when opened for writing. A `FileExistsError` will be raised if it already\n" "when opened for writing. A FileExistsError will be raised if it already\n"
"exists when opened for creating. Opening a file for creating implies\n" "exists when opened for creating. Opening a file for creating implies\n"
"writing so this mode behaves in a similar way to 'w'.Add a '+' to the mode\n" "writing so this mode behaves in a similar way to 'w'.Add a '+' to the mode\n"
"to allow simultaneous reading and writing. A custom opener can be used by\n" "to allow simultaneous reading and writing. A custom opener can be used by\n"
@ -1043,22 +1043,22 @@ PyDoc_STRVAR(write_doc,
"write(b: bytes) -> int. Write bytes b to file, return number written.\n" "write(b: bytes) -> int. Write bytes b to file, return number written.\n"
"\n" "\n"
"Only makes one system call, so not all of the data may be written.\n" "Only makes one system call, so not all of the data may be written.\n"
"The number of bytes actually written is returned."); "The number of bytes actually written is returned. In non-blocking mode,\n"
"returns None if the write would block."
);
PyDoc_STRVAR(fileno_doc, PyDoc_STRVAR(fileno_doc,
"fileno() -> int. \"file descriptor\".\n" "fileno() -> int. Return the underlying file descriptor (an integer).");
"\n"
"This is needed for lower-level file interfaces, such the fcntl module.");
PyDoc_STRVAR(seek_doc, PyDoc_STRVAR(seek_doc,
"seek(offset: int[, whence: int]) -> int. Move to new file position and\n" "seek(offset: int[, whence: int]) -> int. Move to new file position and\n"
"return the file position.\n" "return the file position.\n"
"\n" "\n"
"Argument offset is a byte count. Optional argument whence defaults to\n" "Argument offset is a byte count. Optional argument whence defaults to\n"
"0 (offset from start of file, offset should be >= 0); other values are 1\n" "SEEK_SET or 0 (offset from start of file, offset should be >= 0); other values\n"
"(move relative to current position, positive or negative), and 2 (move\n" "are SEEK_CUR or 1 (move relative to current position, positive or negative),\n"
"relative to end of file, usually negative, although many platforms allow\n" "and SEEK_END or 2 (move relative to end of file, usually negative, although\n"
"seeking beyond the end of a file)." "many platforms allow seeking beyond the end of a file).\n"
"\n" "\n"
"Note that not all file objects are seekable."); "Note that not all file objects are seekable.");
@ -1072,7 +1072,10 @@ PyDoc_STRVAR(truncate_doc,
#endif #endif
PyDoc_STRVAR(tell_doc, PyDoc_STRVAR(tell_doc,
"tell() -> int. Current file position"); "tell() -> int. Current file position.\n"
"\n"
"Can raise OSError for non seekable files."
);
PyDoc_STRVAR(readinto_doc, PyDoc_STRVAR(readinto_doc,
"readinto() -> Same as RawIOBase.readinto()."); "readinto() -> Same as RawIOBase.readinto().");
@ -1081,10 +1084,10 @@ PyDoc_STRVAR(close_doc,
"close() -> None. Close the file.\n" "close() -> None. Close the file.\n"
"\n" "\n"
"A closed file cannot be used for further I/O operations. close() may be\n" "A closed file cannot be used for further I/O operations. close() may be\n"
"called more than once without error. Changes the fileno to -1."); "called more than once without error.");
PyDoc_STRVAR(isatty_doc, PyDoc_STRVAR(isatty_doc,
"isatty() -> bool. True if the file is connected to a tty device."); "isatty() -> bool. True if the file is connected to a TTY device.");
PyDoc_STRVAR(seekable_doc, PyDoc_STRVAR(seekable_doc,
"seekable() -> bool. True if file supports random-access."); "seekable() -> bool. True if file supports random-access.");
@ -1139,7 +1142,7 @@ get_mode(fileio *self, void *closure)
static PyGetSetDef fileio_getsetlist[] = { static PyGetSetDef fileio_getsetlist[] = {
{"closed", (getter)get_closed, NULL, "True if the file is closed"}, {"closed", (getter)get_closed, NULL, "True if the file is closed"},
{"closefd", (getter)get_closefd, NULL, {"closefd", (getter)get_closefd, NULL,
"True if the file descriptor will be closed"}, "True if the file descriptor will be closed by close()."},
{"mode", (getter)get_mode, NULL, "String giving the file mode"}, {"mode", (getter)get_mode, NULL, "String giving the file mode"},
{NULL}, {NULL},
}; };