itertools.batched() în Python
În această lecție vei învăța cum folosești itertools.batched() pentru a împărți elementele unui iterabil în grupuri consecutive de dimensiune fixă.
Ce problemă rezolvă batched()?
Uneori ai multe valori și vrei să le procesezi în grupuri mai mici.
Valori: 1, 2, 3, 4, 5, 6 Dimensiunea grupului: 2
Rezultatul dorit este:
(1, 2) (3, 4) (5, 6)
Ce face batched()?
Funcția batched() preia elementele în ordine și produce tuple consecutive cu cel mult n elemente.
from itertools import batched numere = [1, 2, 3, 4, 5, 6] grupuri = batched(numere, 2) print(list(grupuri))
[(1, 2), (3, 4), (5, 6)]
Importarea funcției batched
from itertools import batched
batched() face parte din modulul itertools și este disponibilă începând cu Python 3.12.
Sintaxa
batched(iterable, n)
Primul argument este obiectul iterabil.
Al doilea argument stabilește numărul maxim de elemente din fiecare grup.
Rezultatele sunt tuple
from itertools import batched grupuri = batched(["A", "B", "C", "D"], 2) print(next(grupuri)) print(next(grupuri))
('A', 'B')
('C', 'D') Fiecare grup produs de batched() este un tuplu.
Ultimul grup poate fi mai scurt
from itertools import batched numere = [1, 2, 3, 4, 5] print(list(batched(numere, 2)))
[(1, 2), (3, 4), (5,)]
Ultimul grup conține un singur element deoarece sursa s-a terminat.
Ordinea elementelor este păstrată
from itertools import batched valori = ["D", "A", "C", "B"] print(list(batched(valori, 2)))
[('D', 'A'), ('C', 'B')] batched() nu sortează și nu modifică ordinea valorilor.
Grupuri de câte trei elemente
from itertools import batched numere = [10, 20, 30, 40, 50, 60] print(list(batched(numere, 3)))
[(10, 20, 30), (40, 50, 60)]
Dimensiunea 1
from itertools import batched print(list(batched(["A", "B", "C"], 1)))
[('A',), ('B',), ('C',)] Fiecare element este plasat într-un tuplu separat.
Dimensiunea trebuie să fie pozitivă
from itertools import batched grupuri = batched([1, 2, 3], 0)
O dimensiune egală cu zero sau negativă produce ValueError.
Un iterabil gol
from itertools import batched print(list(batched([], 3)))
[]
Nu este produs niciun grup.
Un singur element
from itertools import batched print(list(batched([100], 3)))
[(100,)]
Dimensiunea mai mare decât colecția
from itertools import batched print(list(batched([1, 2, 3], 10)))
[(1, 2, 3)]
Toate valorile intră într-un singur grup.
Parcurgerea cu for
from itertools import batched
cursanti = ["Ana", "Mihai", "Ioana", "Radu"]
for grupa in batched(cursanti, 2):
print(grupa) ('Ana', 'Mihai')
('Ioana', 'Radu') Folosirea cu stringuri
from itertools import batched
print(list(batched("PYTHON", 2))) [('P', 'Y'), ('T', 'H'), ('O', 'N')] Stringul este parcurs caracter cu caracter.
Folosirea cu tuple
from itertools import batched valori = (10, 20, 30, 40, 50) print(list(batched(valori, 2)))
[(10, 20), (30, 40), (50,)]
Folosirea cu range()
from itertools import batched print(list(batched(range(1, 8), 3)))
[(1, 2, 3), (4, 5, 6), (7,)]
Folosirea cu un generator
from itertools import batched
def genereaza():
yield 10
yield 20
yield 30
yield 40
print(list(batched(genereaza(), 2))) [(10, 20), (30, 40)]
Rezultatul este un iterator
from itertools import batched grupuri = batched([1, 2, 3, 4], 2) print(next(grupuri)) print(next(grupuri))
(1, 2) (3, 4)
Grupurile sunt create pe măsură ce sunt cerute.
Sursa este consumată treptat
from itertools import batched sursa = iter([1, 2, 3, 4, 5]) grupuri = batched(sursa, 2) print(next(grupuri)) print(next(sursa))
(1, 2) 3
Primul grup consumă primele două valori din iteratorul sursă.
Iteratorul rezultat este consumabil
from itertools import batched grupuri = batched([1, 2, 3, 4], 2) print(list(grupuri)) print(list(grupuri))
[(1, 2), (3, 4)] []
Datele originale nu sunt modificate
from itertools import batched numere = [1, 2, 3, 4] grupuri = list(batched(numere, 2)) print(numere) print(grupuri)
[1, 2, 3, 4] [(1, 2), (3, 4)]
Procesarea elementelor pe pagini
from itertools import batched
rezultate = [
"Rezultat 1",
"Rezultat 2",
"Rezultat 3",
"Rezultat 4",
"Rezultat 5"
]
for pagina in batched(rezultate, 2):
print(pagina) ('Rezultat 1', 'Rezultat 2')
('Rezultat 3', 'Rezultat 4')
('Rezultat 5',) Trimiterea datelor în loturi
from itertools import batched
id_uri = [101, 102, 103, 104, 105]
for lot in batched(id_uri, 2):
print("Trimit:", lot) Trimit: (101, 102) Trimit: (103, 104) Trimit: (105,)
Calcularea sumei fiecărui grup
from itertools import batched
numere = [10, 20, 30, 40, 50]
for grup in batched(numere, 2):
print(sum(grup)) 30 70 50
Diferența față de slicing
Slicing-ul este potrivit pentru colecții care permit indexarea.
numere = [1, 2, 3, 4] print(numere[0:2]) print(numere[2:4])
batched() funcționează și cu generatoare sau alte iteratoare care nu permit indexare.
Diferența față de pairwise()
pairwise() creează perechi consecutive care se suprapun.
from itertools import pairwise print(list(pairwise([1, 2, 3, 4])))
[(1, 2), (2, 3), (3, 4)]
batched() creează grupuri separate, fără suprapunere.
from itertools import batched print(list(batched([1, 2, 3, 4], 2)))
[(1, 2), (3, 4)]
Grupurile nu sunt completate automat
Dacă ultimul grup este incomplet, batched() nu adaugă valori artificiale.
from itertools import batched print(list(batched([1, 2, 3], 2)))
[(1, 2), (3,)]
Pentru completarea pozițiilor lipsă ai nevoie de o altă strategie, de exemplu zip_longest().
Când este util batched()?
batched() este util când trebuie să procesezi datele în loturi de dimensiune fixă.
Îl poți folosi pentru paginare, apeluri către API-uri, inserări în baze de date, trimiterea mesajelor, procesarea fișierelor și împărțirea cursanților în grupe.
Greșeli frecvente
Te aștepți ca ultimul grup să fie complet
Ultimul tuplu poate avea mai puține elemente decât n.
Folosești o dimensiune zero sau negativă
Dimensiunea grupului trebuie să fie cel puțin 1.
Confunzi batched() cu pairwise()
batched() creează grupuri separate, nu perechi suprapuse.
Reutilizezi iteratorul consumat
Creează un obiect batched() nou pentru o altă parcurgere.
Rezumat
Grupuri consecutiveElementele sunt preluate în ordinea sursei.
Dimensiune fixăn stabilește numărul maxim de elemente dintr-un grup.
Ultimul grupPoate conține mai puține elemente.
IteratorTuplele sunt create pe măsură ce sunt cerute.
Folosește exact un import, cinci instrucțiuni de atribuire, un singur apel batched(), trei apeluri next() și trei apeluri print(). Nu folosi for, while, list(), tuple(), pairwise(), slicing, indexare, comprehensions, funcții definite cu def…
Exercițiul, editorul și verificarea automată se deblochează cu Python OOP.

Alex Cristian
Iulian Pahom
Catalina Ioana Dan