Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
cpython
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Kirill Smelkov
cpython
Commits
70781f54
Commit
70781f54
authored
Sep 15, 2010
by
Antoine Pitrou
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add a glossary entry for file objects.
parent
55bfaa3b
Changes
3
Hide whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
21 additions
and
4 deletions
+21
-4
Doc/glossary.rst
Doc/glossary.rst
+17
-0
Doc/library/socket.rst
Doc/library/socket.rst
+1
-1
Doc/reference/datamodel.rst
Doc/reference/datamodel.rst
+3
-3
No files found.
Doc/glossary.rst
View file @
70781f54
...
...
@@ -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
...
...
Doc/library/socket.rst
View file @
70781f54
...
...
@@ -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.
...
...
Doc/reference/datamodel.rst
View file @
70781f54
...
...
@@ -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 availabl
e
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 ar
e
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).
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment