Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła