Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes