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