Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

UnboundLocalError — odczyt niezwiązanej zmiennej lokalnej

UnboundLocalError występuje, gdy funkcja odczytuje zmienną lokalną, która w tym momencie nie ma przypisanej wartości. Jest podklasą NameError; częstą przyczyną jest przypisanie przesłaniające zmienną z zewnętrznego zakresu.

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

Składnia

UnboundLocalError

UnboundLocalError oznacza próbę odczytu zmiennej lokalnej funkcji, która w danym momencie nie jest związana z wartością. Jest podklasą NameError: brak znalezionej nazwy powoduje NameError, natomiast ten szczególny przypadek niezwiązanej zmiennej lokalnej powoduje UnboundLocalError.

Przypisanie do nazwy w funkcji sprawia, że jest ona lokalna w całym jej ciele, chyba że obowiązuje deklaracja global lub nonlocal. Dotyczy to również przypisania w niewykonanej gałęzi. W przykładzie count += 1 musi najpierw odczytać lokalne count; nie korzysta z modułowego count = 10. Wyjątek przerywa wywołanie, a wartość modułowa pozostaje równa 10.

Napraw przyczynę: zapewnij przypisanie wartości przed każdym możliwym odczytem albo przekaż wartość jako argument i zwróć wynik. Jeśli zamierzasz zmieniać powiązanie w module, użyj global; dla istniejącego powiązania w najbliższej obejmującej funkcji użyj nonlocal. Deklarację umieść przed użyciem nazwy. Przechwycenie wyjątku w przykładzie służy demonstracji, nie naprawia błędu zakresu.

Przykłady

count = 10


def increment():
    count += 1
    return count


try:
    increment()
except UnboundLocalError as error:
    print(type(error).__name__)

print(count)

Wynik

UnboundLocalError
10

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła