Valoarea finală a generatorului
În această lecție vei învăța ce se întâmplă când o funcție generatoare folosește return și cum poți recupera valoarea finală din excepția StopIteration.
Recapitulare: finalul unui generator
Un generator produce valori cu yield și se încheie atunci când funcția ajunge la final.
def genereaza_numere():
yield 10
yield 20
generator = genereaza_numere()
print(next(generator))
print(next(generator)) 10 20
Un nou apel next() ar produce excepția StopIteration, deoarece generatorul nu mai are valori.
return într-o funcție generatoare
O funcție generatoare poate conține și instrucțiunea return.
def genereaza():
yield "Valoare"
return "Generator finalizat" Într-un generator, return nu produce încă o valoare obișnuită. El încheie generatorul.
Diferență importantăyield produce o valoare și pune funcția pe pauză. return oprește definitiv generatorul.
Valoarea returnată nu apare într-o buclă for
def genereaza():
yield 1
yield 2
return 100
for valoare in genereaza():
print(valoare) 1 2
Numărul 100 nu este afișat. Bucla for tratează automat StopIteration și se oprește fără să expună valoarea returnată.
Unde este păstrată valoarea returnată?
Valoarea transmisă prin return este atașată excepției StopIteration.
def genereaza():
yield "Pas"
return "Final" Când generatorul ajunge la return, Python produce intern ceva echivalent cu:
StopIteration("Final") Valoarea poate fi citită prin atributul value.
Capturarea excepției StopIteration
def genereaza():
yield "Primul pas"
return "Proces terminat"
generator = genereaza()
print(next(generator))
try:
next(generator)
except StopIteration as eroare:
print(eroare.value) Primul pas Proces terminat
Al doilea next() ajunge la return. Excepția este capturată, iar valoarea finală este disponibilă în eroare.value.
return fără valoare
def genereaza():
yield 10
return
generator = genereaza()
print(next(generator))
try:
next(generator)
except StopIteration as eroare:
print(eroare.value) 10 None
Un return fără expresie încheie generatorul cu valoarea finală None.
Finalul natural are tot valoarea None
def genereaza():
yield 10
generator = genereaza()
print(next(generator))
try:
next(generator)
except StopIteration as eroare:
print(eroare.value) 10 None
Dacă funcția ajunge natural la final, rezultatul este echivalent cu return fără valoare.
Mai multe valori yield înainte de return
def proceseaza():
yield "Citire"
yield "Validare"
yield "Salvare"
return "Succes"
generator = proceseaza()
print(next(generator))
print(next(generator))
print(next(generator))
try:
next(generator)
except StopIteration as eroare:
print(eroare.value) Citire Validare Salvare Succes
return oprește imediat generatorul
def genereaza():
yield 1
return "Stop"
yield 2 Valoarea 2 nu va fi produsă niciodată, deoarece return încheie generatorul înainte de ultimul yield.
Valoarea finală poate fi calculată
def calculeaza():
total = 0
for numar in range(1, 4):
total += numar
yield numar
return total Generatorul produce 1, 2 și 3, iar la final returnează totalul 6 prin StopIteration.value.
Exemplu complet cu un total
def calculeaza():
total = 0
for numar in range(1, 4):
total += numar
yield numar
return total
generator = calculeaza()
while True:
try:
print(next(generator))
except StopIteration as eroare:
print(f"Total: {eroare.value}")
break 1 2 3 Total: 6
De ce bucla for ascunde valoarea finală?
Bucla for folosește intern next() și se oprește automat când întâlnește StopIteration.
Acest comportament face iterarea simplă, dar înseamnă că valoarea din StopIteration.value nu este oferită direct corpului buclei.
Valoarea returnată și yield from
yield from poate recupera automat valoarea returnată de un subgenerator.
def subgenerator():
yield 1
yield 2
return 3
def generator_principal():
rezultat = yield from subgenerator()
yield f"Rezultat final: {rezultat}"
for valoare in generator_principal():
print(valoare) 1 2 Rezultat final: 3
Valoarea returnată de subgenerator devine rezultatul expresiei yield from.
Returnarea unui mesaj final
def exporta_date():
yield "Fișier creat"
yield "Date scrise"
return "Export finalizat"
generator = exporta_date()
print(next(generator))
print(next(generator))
try:
next(generator)
except StopIteration as eroare:
print(eroare.value) Fișier creat Date scrise Export finalizat
Returnarea unui rezultat numeric
def proceseaza_comenzi():
yield "Comanda 1"
yield "Comanda 2"
return 2
generator = proceseaza_comenzi()
print(next(generator))
print(next(generator))
try:
next(generator)
except StopIteration as eroare:
print(f"Comenzi procesate: {eroare.value}") Comanda 1 Comanda 2 Comenzi procesate: 2
Când este utilă valoarea finală?
Valoarea finală este utilă când generatorul produce elemente pe parcurs, dar trebuie să comunice și un rezultat final.
Exemplele includ un total, numărul elementelor procesate, un mesaj de stare sau rezultatul unui subgenerator.
Greșeli frecvente
Te aștepți ca return să producă o valoare în for
Bucla for afișează doar valorile produse cu yield.
Nu capturezi StopIteration
Pentru a accesa valoarea finală manual, folosește try/except în jurul apelului next() care încheie generatorul.
Folosești eroarea în loc de eroare.value
Atributul value conține exact obiectul transmis prin return.
Pui yield după return
Codul aflat după return nu mai este executat.
Rezumat
returnÎncheie definitiv funcția generatoare.
StopIterationSemnalează că generatorul nu mai are valori.
valuePăstrează valoarea finală transmisă prin return.
forConsumă generatorul, dar ascunde valoarea finală.
Creează funcția generatoare proceseaza_fisiere(). Creează variabila generator apelând exact proceseaza_fisiere(). Folosește exact o funcție, două yield-uri, un return, o atribuire, un bloc try, un bloc except, trei apeluri next() și trei ap…
Exercițiul, editorul și verificarea automată se deblochează cu Python OOP.

Alex Cristian
Iulian Pahom
Catalina Ioana Dan