mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

Minor clarification about fdopen().

Browse source
This commit is contained in:
Georg Brandl 2012-06-24 13:24:56 +02:00
parent b8f2d29ea9
commit b2462e2b8c
1 changed files with 10 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

19
Doc/library/os.rst
View file

@ -600,15 +600,16 @@ process and user.
File Object Creation File Object Creation
-------------------- --------------------
These functions create new :term:`file objects <file object>`. (See also :func:`open`.) These functions create new :term:`file objects <file object>`. (See also
:func:`~os.open` for opening file descriptors.)
.. function:: fdopen(fd, *args, **kwargs) .. function:: fdopen(fd, *args, **kwargs)
Return an open file object connected to the file descriptor *fd*. Return an open file object connected to the file descriptor *fd*. This is an
This is an alias of :func:`open` and accepts the same arguments. alias of the :func:`open` built-in function and accepts the same arguments.
The only difference is that the first argument of :func:`fdopen` The only difference is that the first argument of :func:`fdopen` must always
must always be an integer. be an integer.
.. _os-fd-ops: .. _os-fd-ops:
@ -952,10 +953,10 @@ as internal buffering of data.
.. note:: .. note::
This function is intended for low-level I/O and must be applied to a file This function is intended for low-level I/O and must be applied to a file
descriptor as returned by :func:`os.open` or :func:`pipe`. To read a "file object" descriptor as returned by :func:`os.open` or :func:`pipe`. To read a
returned by the built-in function :func:`open` or by :func:`popen` or "file object" returned by the built-in function :func:`open` or by
:func:`fdopen`, or :data:`sys.stdin`, use its :meth:`~file.read` or :func:`popen` or :func:`fdopen`, or :data:`sys.stdin`, use its
:meth:`~file.readline` methods. :meth:`~file.read` or :meth:`~file.readline` methods.
.. function:: sendfile(out, in, offset, nbytes) .. function:: sendfile(out, in, offset, nbytes)