CKTIS / Python
itertools.batched
Pobiera kolejne elementy do krotek o rozmiarze n, przy czym n musi wynosić co najmniej 1.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
itertools.batched(iterable, n, *, strict=False)Pobiera kolejne elementy do krotek o rozmiarze n, przy czym n musi wynosić co najmniej 1.
Funkcję wprowadzono w Pythonie 3.12, a parametr strict w wersji 3.13. Domyślnie ostatnia krotka może być krótsza niż n i tutaj ma postać ('e',). Dla abcde i n=2 powstają pary ab i cd oraz końcowe e. Pusty strumień nie daje krotki.
W trybie strict=True niepełna ostatnia grupa wywołuje ValueError podczas iteracji.
import itertools as I
chunks = I.batched("abc", 2, strict=True)
assert next(chunks) == ("a", "b")
try:
next(chunks)
except ValueError:
pass
else:
raise AssertionError
Przykłady
import itertools as I
print(list(I.batched("abcde", 2)))
print(list(I.batched([], 3)))
Wynik
[('a', 'b'), ('c', 'd'), ('e',)]
[]W trybie strict=True niepełna ostatnia grupa wywołuje ValueError podczas iteracji.