mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

Docs: Clarify the before_and_after() example (GH-28458)

Browse source
This commit is contained in:
Raymond Hettinger 2021-09-19 19:52:27 -05:00 • committed by GitHub
parent a6779715c4
commit fcbf9b176b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 8 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

7
Doc/library/itertools.rst
View file

@ -859,10 +859,11 @@ which incur interpreter overhead.
""" Variant of takewhile() that allows complete """ Variant of takewhile() that allows complete
access to the remainder of the iterator. access to the remainder of the iterator.
>>> all_upper, remainder = before_and_after(str.isupper, 'ABCdEfGhI') >>> it = iter('ABCdEfGhI')
>>> str.join('', all_upper) >>> all_upper, remainder = before_and_after(str.isupper, it)
>>> ''.join(all_upper)
'ABC' 'ABC'
>>> str.join('', remainder) >>> ''.join(remainder) # takewhile() would lose the 'd'
'dEfGhI' 'dEfGhI'
Note that the first iterator must be fully Note that the first iterator must be fully

7
Lib/test/test_itertools.py
View file

@ -2646,10 +2646,11 @@ True
>>> list(odds) >>> list(odds)
[1, 3, 5, 7, 9] [1, 3, 5, 7, 9]
>>> all_upper, remainder = before_and_after(str.isupper, 'ABCdEfGhI') >>> it = iter('ABCdEfGhI')
>>> str.join('', all_upper) >>> all_upper, remainder = before_and_after(str.isupper, it)
>>> ''.join(all_upper)
'ABC' 'ABC'
>>> str.join('', remainder) >>> ''.join(remainder)
'dEfGhI' 'dEfGhI'
>>> list(powerset([1,2,3])) >>> list(powerset([1,2,3]))