Commit fa52cbd5 authored by Petri Lehtinen's avatar Petri Lehtinen

#14863: Update the documentation of os.fdopen()

parents 4715ca56 1a01ebc4
...@@ -600,26 +600,13 @@ File Object Creation ...@@ -600,26 +600,13 @@ 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:`open`.)
.. function:: fdopen(fd[, mode[, bufsize]]) .. function:: fdopen(fd, *args, **kwargs)
.. index:: single: I/O control; buffering Return an open file object connected to the file descriptor *fd*.
This is an alias of :func:`open` and accepts the same arguments.
The only difference is that the first argument of :func:`fdopen`
must always be an integer.
Return an open file object connected to the file descriptor *fd*. The *mode*
and *bufsize* arguments have the same meaning as the corresponding arguments to
the built-in :func:`open` function.
When specified, the *mode* argument must start with one of the letters
``'r'``, ``'w'``, ``'x'`` or ``'a'``, otherwise a :exc:`ValueError` is
raised.
On Unix, when the *mode* argument starts with ``'a'``, the *O_APPEND* flag is
set on the file descriptor (which the :c:func:`fdopen` implementation already
does on most platforms).
Availability: Unix, Windows.
.. versionchanged:: 3.3
The ``'x'`` mode was added.
.. _os-fd-ops: .. _os-fd-ops:
......
...@@ -42,6 +42,9 @@ Core and Builtins ...@@ -42,6 +42,9 @@ Core and Builtins
Library Library
------- -------
- Issue #14863: Update the documentation of os.fdopen() to reflect the
fact that it's only a thin wrapper around open() anymore.
- Issue #14036: Add an additional check to validate that port in urlparse does - Issue #14036: Add an additional check to validate that port in urlparse does
not go in illegal range and returns None. not go in illegal range and returns None.
......
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