Kaydet (Commit) b2462e2b authored tarafından Georg Brandl's avatar Georg Brandl

Minor clarification about fdopen().

üst b8f2d29e
...@@ -600,15 +600,16 @@ process and user. ...@@ -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. ...@@ -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)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment