summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSandro Tosi <sandro.tosi@gmail.com>2012-08-15 19:37:35 (GMT)
committerSandro Tosi <sandro.tosi@gmail.com>2012-08-15 19:37:35 (GMT)
commitdd7c55250d67de4d430a0c51dba4f3c0cd8f6ed3 (patch)
treedf7dec7867727d322742c80a6c06442d1765b369
parentee0a945ae4077d9e4ffdb77e247ed13265316897 (diff)
downloadcpython-dd7c55250d67de4d430a0c51dba4f3c0cd8f6ed3.zip
cpython-dd7c55250d67de4d430a0c51dba4f3c0cd8f6ed3.tar.gz
cpython-dd7c55250d67de4d430a0c51dba4f3c0cd8f6ed3.tar.bz2
clarify in/not in in case of infinite iterators; thanks to Sergey Skovorodkin from docs@
-rw-r--r--Doc/howto/functional.rst4
1 files changed, 2 insertions, 2 deletions
diff --git a/Doc/howto/functional.rst b/Doc/howto/functional.rst
index 8934d5e..f1ed07b 100644
--- a/Doc/howto/functional.rst
+++ b/Doc/howto/functional.rst
@@ -246,9 +246,9 @@ Built-in functions such as :func:`max` and :func:`min` can take a single
iterator argument and will return the largest or smallest element. The ``"in"``
and ``"not in"`` operators also support iterators: ``X in iterator`` is true if
X is found in the stream returned by the iterator. You'll run into obvious
-problems if the iterator is infinite; ``max()``, ``min()``, and ``"not in"``
+problems if the iterator is infinite; ``max()``, ``min()``
will never return, and if the element X never appears in the stream, the
-``"in"`` operator won't return either.
+``"in"`` and ``"not in"`` operators won't return either.
Note that you can only go forward in an iterator; there's no way to get the
previous element, reset the iterator, or make a copy of it. Iterator objects