CKTIS / Python
itertools.batched
Lê elementos consecutivos em tuplos de tamanho n, sendo n pelo menos 1.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
itertools.batched(iterable, n, *, strict=False)Lê elementos consecutivos em tuplos de tamanho n, sendo n pelo menos 1.
A função foi introduzida no Python 3.12 e o parâmetro strict na versão 3.13. Por predefinição o último tuplo pode ser mais curto do que n e aqui é ('e',). Para abcde e n=2 obtêm-se ab, cd e por fim e. Uma entrada vazia não dá tuplos.
Com strict=True o grupo final incompleto gera ValueError durante a iteração.
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
Exemplos
import itertools as I
print(list(I.batched("abcde", 2)))
print(list(I.batched([], 3)))
Resultado
[('a', 'b'), ('c', 'd'), ('e',)]
[]Com strict=True o grupo final incompleto gera ValueError durante a iteração.