ada/cpython
0
0
Fork 0
mirror of https://github.com/AdaCore/cpython.git synced 2026-02-12 12:57:15 -08:00
Code Issues Packages Projects Releases Wiki Activity

bpo-15718: Document the upper bound constrain on the __len__ return value. (#1256)

Browse Source
This commit is contained in:
Serhiy Storchaka
2017-04-23 08:37:58 +03:00
committed by GitHub
parent 997a4adea6
commit 85157cd89a
1 changed files with 9 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
Doc/reference/datamodel.rst
View File

@@ -2011,6 +2011,14 @@ through the container; for mappings, :meth:`__iter__` should be the same as
:meth:`__bool__` method and whose :meth:`__len__` method returns zero is :meth:`__bool__` method and whose :meth:`__len__` method returns zero is
considered to be false in a Boolean context. considered to be false in a Boolean context.
.. impl-detail::
In CPython, the length is required to be at most :attr:`sys.maxsize`.
If the length is larger than :attr:`!sys.maxsize` some features (such as
:func:`len`) may raise :exc:`OverflowError`. To prevent raising
:exc:`!OverflowError` by truth value testing, an object must define a
:meth:`__bool__` method.
.. method:: object.__length_hint__(self) .. method:: object.__length_hint__(self)
@@ -2021,6 +2029,7 @@ through the container; for mappings, :meth:`__iter__` should be the same as
.. versionadded:: 3.4 .. versionadded:: 3.4
.. note:: .. note::
Slicing is done exclusively with the following three methods. A call like :: Slicing is done exclusively with the following three methods. A call like ::