mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-01 18:51:43 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 21

Add a glossary entry for file objects.

Browse source
This commit is contained in:
Antoine Pitrou 2010-09-15 09:58:26 +00:00
parent 5aa0d10560
commit 0b65b0fc83
3 changed files with 21 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

17
Doc/glossary.rst
View file

@ -184,6 +184,23 @@ Glossary
A module written in C or C++, using Python's C API to interact with the core and
with user code.
file object
An object exposing a file-oriented API (with methods such as
:meth:`read()` or :meth:`write()`) to an underlying resource.
Depending on the way it was created, a file object can mediate access
to a real on-disk file or to another other type of storage or
communication device (for example standard input/output, in-memory
buffers, sockets, pipes, etc.). File objects are also called
:dfn:`file-like objects` or :dfn:`streams`.
There are actually three categories of file objects: raw binary
files, buffered binary files and text files. Their interfaces are
defined in the :mod:`io` module. The canonical way to create a
file object is by using the :func:`open` function.
file-like object
A synonym for :term:`file object`.
finder
An object that tries to find the :term:`loader` for a module. It must
implement a method named :meth:`find_module`. See :pep:`302` for

2
Doc/library/socket.rst
View file

@ -617,7 +617,7 @@ correspond to Unix system calls applicable to sockets.
.. index:: single: I/O control; buffering
Return a :dfn:`file object` associated with the socket. The exact
Return a :term:`file object` associated with the socket. The exact
returned type depends on the arguments given to :meth:`makefile`. These
arguments are interpreted the same way as by the built-in :func:`open`
function.

6
Doc/reference/datamodel.rst
View file

@ -781,9 +781,9 @@ I/O objects (also known as file objects)
single: stdout (in module sys)
single: stderr (in module sys)
A file object represents an open file. Various shortcuts are available
to create file objects: the :func:`open` built-in function, and also
:func:`os.popen`, :func:`os.fdopen`, and the :meth:`makefile` method
A :term:`file object` represents an open file. Various shortcuts are
available to create file objects: the :func:`open` built-in function, and
also :func:`os.popen`, :func:`os.fdopen`, and the :meth:`makefile` method
of socket objects (and perhaps by other functions or methods provided
by extension modules).