Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

UnboundLocalError

UnboundLocalError 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.

Zdroje