summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2021-09-20 01:53:37 (GMT)
committerPablo Galindo <pablogsal@gmail.com>2021-09-29 11:31:16 (GMT)
commit0a74d33e14538849216271c3610ea4e301f7370f (patch)
treefd8240efc7eb31e037177b8cbe6be43c89e3c10a /Doc
parent2e4d66d2e71d36de394e0e7a4e60ed7b6a539933 (diff)
downloadcpython-0a74d33e14538849216271c3610ea4e301f7370f.zip
cpython-0a74d33e14538849216271c3610ea4e301f7370f.tar.gz
cpython-0a74d33e14538849216271c3610ea4e301f7370f.tar.bz2
Docs: Clarify the before_and_after() example (GH-28458) (#28464)
(cherry picked from commit fcbf9b176b1190301c760a921601c6488ef8b070) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com> Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/itertools.rst7
1 files changed, 4 insertions, 3 deletions
diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index bf60a0c..8341ce3 100644
--- a/Doc/library/itertools.rst
+++ b/Doc/library/itertools.rst
@@ -859,10 +859,11 @@ which incur interpreter overhead.
""" Variant of takewhile() that allows complete
access to the remainder of the iterator.
- >>> all_upper, remainder = before_and_after(str.isupper, 'ABCdEfGhI')
- >>> str.join('', all_upper)
+ >>> it = iter('ABCdEfGhI')
+ >>> all_upper, remainder = before_and_after(str.isupper, it)
+ >>> ''.join(all_upper)
'ABC'
- >>> str.join('', remainder)
+ >>> ''.join(remainder) # takewhile() would lose the 'd'
'dEfGhI'
Note that the first iterator must be fully