CKTIS / Python
UnboundLocalError – čítanie nenaviazanej lokálnej premennej
UnboundLocalError nastane, keď funkcia číta lokálnu premennú, ktorej v danom okamihu nie je priradená žiadna hodnota. Je podtriedou NameError; častou príčinou je priradenie, ktoré zatieni premennú z vonkajšieho rozsahu platnosti.
Verzia: Python 3.14; repository image, production runtime not attested
Syntax
UnboundLocalErrorUnboundLocalError označuje pokus prečítať lokálnu premennú funkcie, ktorá v danom okamihu nie je naviazaná na žiadnu hodnotu. Je podtriedou NameError: ak sa názov nenájde, vznikne NameError, zatiaľ čo tento konkrétny prípad nenaviazanej lokálnej premennej spôsobí UnboundLocalError.
Priradenie hodnoty názvu vo funkcii z neho urobí lokálny názov v celom tele funkcie, pokiaľ sa neuplatní deklarácia global alebo nonlocal. Platí to aj pre priradenie vo vetve, ktorá sa nikdy nevykoná. V príklade musí count += 1 najprv prečítať lokálne count; nepoužije count = 10 na úrovni modulu. Výnimka preruší volanie a hodnota na úrovni modulu zostane 10.
Opravte príčinu: zabezpečte priradenie hodnoty pred každým možným čítaním, alebo hodnotu odovzdajte ako argument a vráťte výsledok. Ak chcete znova naviazať názov na úrovni modulu, použite global; pre existujúcu väzbu v najbližšej obklopujúcej funkcii použite nonlocal. Deklaráciu umiestnite pred použitie názvu. Zachytenie výnimky v príklade slúži na demonštráciu, nie na opravu chyby rozsahu platnosti.
Príklady
count = 10
def increment():
count += 1
return count
try:
increment()
except UnboundLocalError as error:
print(type(error).__name__)
print(count)
Výsledok
UnboundLocalError 10
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.