diff options
| author | R David Murray <rdmurray@bitdance.com> | 2014-03-10 19:00:33 (GMT) |
|---|---|---|
| committer | R David Murray <rdmurray@bitdance.com> | 2014-03-10 19:00:33 (GMT) |
| commit | e8db162f62c369ce6dcbb92190d0aa2c03a15acb (patch) | |
| tree | 31c26f7d0dfc915ddd687235164b7109cc11094e /Doc | |
| parent | d840b8d6139ed0784d7fea1293a6b7d88a1d8a4f (diff) | |
| download | cpython-e8db162f62c369ce6dcbb92190d0aa2c03a15acb.zip cpython-e8db162f62c369ce6dcbb92190d0aa2c03a15acb.tar.gz cpython-e8db162f62c369ce6dcbb92190d0aa2c03a15acb.tar.bz2 | |
whatsnew: PEP 424 implementation.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/c-api/object.rst | 6 | ||||
| -rw-r--r-- | Doc/library/operator.rst | 4 | ||||
| -rw-r--r-- | Doc/whatsnew/3.4.rst | 13 |
3 files changed, 18 insertions, 5 deletions
diff --git a/Doc/c-api/object.rst b/Doc/c-api/object.rst index ad84301..509ca3f 100644 --- a/Doc/c-api/object.rst +++ b/Doc/c-api/object.rst @@ -357,9 +357,9 @@ attribute is considered sufficient for this determination. .. c:function:: Py_ssize_t PyObject_LengthHint(PyObject *o, Py_ssize_t default) - Return an estimated length for the object *o*. First trying to return its - actual length, then an estimate using ``__length_hint__``, and finally - returning the default value. On error ``-1`` is returned. This is the + Return an estimated length for the object *o*. First try to return its + actual length, then an estimate using :meth:`~object.__length_hint__`, and + finally return the default value. On error return ``-1``. This is the equivalent to the Python expression ``operator.length_hint(o, default)``. .. versionadded:: 3.4 diff --git a/Doc/library/operator.rst b/Doc/library/operator.rst index fa3bcdd..3bcbaa4 100644 --- a/Doc/library/operator.rst +++ b/Doc/library/operator.rst @@ -240,9 +240,9 @@ their character equivalents. .. function:: length_hint(obj, default=0) - Return an estimated length for the object *o*. First trying to return its + Return an estimated length for the object *o*. First try to return its actual length, then an estimate using :meth:`object.__length_hint__`, and - finally returning the default value. + finally return the default value. .. versionadded:: 3.4 diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst index 8cf9165..2190672 100644 --- a/Doc/whatsnew/3.4.rst +++ b/Doc/whatsnew/3.4.rst @@ -393,6 +393,10 @@ Some smaller changes made to the core Python language are: several cases as a result of the introduction of Argument Clinic and other changes to the :mod:`inspect` and :mod:`pydoc` modules. +* :meth:`~object.__length_hint__` is now part of the formal language + specification (see :pep:`424`). (Contributed by Armin Ronacher in + :issue:`16148`.) + New Modules =========== @@ -1098,6 +1102,11 @@ There is now a pure-python version of the :mod:`operator` module available for reference and for use by alternate implementations of Python. (Contributed by Zachary Ware in :issue:`16694`.) +New function :func:`~operator.length_hint` provides an implementation of the +specification for how the :meth:`~object.__length_hint__` special method should +be used, as part of the :pep:`424` formal specification of this language +feature. (Contributed by Armin Ronacher in :issue:`16148`.) + os -- @@ -1800,6 +1809,10 @@ Other Build and C API Changes <http://en.wikipedia.org/wiki/Data_Execution_Prevention>`_. (Contributed by Christian Heimes in :issue:`16632`.) +* New function :c:func:`PyObject_LengthHint` is the C API equivalent + of :func:`operator.length_hint`. (Contributed by Armin Ronacher in + :issue:`16148`.) + .. _other-improvements-3.4: |