CKTIS / Python
UnboundLocalError – čtení nevázané lokální proměnné
UnboundLocalError nastane, když funkce čte lokální proměnnou, které v daném okamžiku není přiřazena žádná hodnota. Jde o podtřídu NameError; častou příčinou je přiřazení, které zastíní proměnnou z vnějšího rozsahu platnosti.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
UnboundLocalErrorUnboundLocalError označuje pokus přečíst lokální proměnnou funkce, která v daném okamžiku není navázána na žádnou hodnotu. Jde o podtřídu NameError: pokud se název nenajde, vznikne NameError, zatímco tento konkrétní případ nevázané lokální proměnné způsobí UnboundLocalError.
Přiřazení hodnoty názvu uvnitř funkce z něj udělá lokální název v celém těle funkce, pokud se neuplatní deklarace global nebo nonlocal. Platí to i pro přiřazení ve větvi, která se nikdy neprovede. V příkladu musí count += 1 nejprve přečíst lokální count; nepoužije count = 10 na úrovni modulu. Výjimka přeruší volání a hodnota na úrovni modulu zůstane 10.
Opravte příčinu: zajistěte přiřazení hodnoty před každým možným čtením, nebo hodnotu předejte jako argument a vraťte výsledek. Pokud chcete znovu navázat název na úrovni modulu, použijte global; pro existující vazbu v nejbližší obklopující funkci použijte nonlocal. Deklaraci umístěte před použití názvu. Zachycení výjimky v příkladu slouží k demonstraci, nikoli k opravě chyby rozsahu platnosti.
Příklady
count = 10
def increment():
count += 1
return count
try:
increment()
except UnboundLocalError as error:
print(type(error).__name__)
print(count)
Výsledek
UnboundLocalError 10
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.