Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

itertools.batched

Lit les éléments successifs en tuples de taille n, avec n au moins égal à 1.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

itertools.batched(iterable, n, *, strict=False)

Lit les éléments successifs en tuples de taille n, avec n au moins égal à 1.

La fonction a été ajoutée en Python 3.12 et le paramètre strict en 3.13. Par défaut le dernier tuple peut être plus court que n et vaut ici ('e',). Pour abcde et n=2 on obtient ab, cd puis e. Une entrée vide ne donne aucun tuple.

Avec strict=True le dernier groupe incomplet lève ValueError pendant l’itération.

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

Exemples

import itertools as I
print(list(I.batched("abcde", 2)))
print(list(I.batched([], 3)))

Résultat

[('a', 'b'), ('c', 'd'), ('e',)]
[]

Avec strict=True le dernier groupe incomplet lève ValueError pendant l’itération.

Sources