From aa3b629a09bfcdf26cdfbbf7d6445ae333c0d44d Mon Sep 17 00:00:00 2001 From: Steve Dower Date: Tue, 10 Sep 2019 15:41:58 +0100 Subject: [PATCH] bpo-37913: document that __length_hint__ can return NotImplemented (GH-15383) --- Doc/reference/datamodel.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst index 962ec7e6c719..f5e23d85b9d8 100644 --- a/Doc/reference/datamodel.rst +++ b/Doc/reference/datamodel.rst @@ -2142,7 +2142,9 @@ through the container; for mappings, :meth:`__iter__` should be the same as Called to implement :func:`operator.length_hint`. Should return an estimated length for the object (which may be greater or less than the actual length). - The length must be an integer ``>=`` 0. This method is purely an + The length must be an integer ``>=`` 0. The return value may also be + :const:`NotImplemented`, which is treated the same as if the + ``__length_hint__`` method didn't exist at all. This method is purely an optimization and is never required for correctness. .. versionadded:: 3.4 -- 2.47.3