From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sat, 18 May 2024 06:51:20 +0000 (+0200) Subject: [3.12] Minor improvements to the docs for itertools.tee() (gh-119135) (gh-119137) X-Git-Tag: v3.12.4~95 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a370eebdd9bcc18d39f9e5d886ddb91a2435033e;p=thirdparty%2FPython%2Fcpython.git [3.12] Minor improvements to the docs for itertools.tee() (gh-119135) (gh-119137) --- diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst index 183aa36d9275..cf2bbf0b1ae6 100644 --- a/Doc/library/itertools.rst +++ b/Doc/library/itertools.rst @@ -690,18 +690,19 @@ loops that truncate the stream. def tee(iterable, n=2): iterator = iter(iterable) - empty_link = [None, None] # Singly linked list: [value, link] - return tuple(_tee(iterator, empty_link) for _ in range(n)) + shared_link = [None, None] + return tuple(_tee(iterator, shared_link) for _ in range(n)) def _tee(iterator, link): - while True: - if link[1] is None: - try: - link[:] = [next(iterator), [None, None]] - except StopIteration: - return - value, link = link - yield value + try: + while True: + if link[1] is None: + link[0] = next(iterator) + link[1] = [None, None] + value, link = link + yield value + except StopIteration: + return Once a :func:`tee` has been created, the original *iterable* should not be used anywhere else; otherwise, the *iterable* could get advanced without