CKTIS / Python
UnboundLocalError — een niet-gebonden lokale variabele lezen
UnboundLocalError treedt op wanneer een functie een lokale variabele leest waaraan op dat moment geen waarde is toegekend. Het is een subklasse van NameError; een veelvoorkomende oorzaak is een toewijzing die een variabele uit een buitenliggende scope overschaduwt.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
UnboundLocalErrorUnboundLocalError betekent dat wordt geprobeerd een lokale variabele van een functie te lezen waaraan op dat moment geen waarde is gekoppeld. Het is een subklasse van NameError: een niet-gevonden naam veroorzaakt NameError, terwijl dit specifieke geval van een niet-gebonden lokale variabele UnboundLocalError veroorzaakt.
Een toewijzing aan een naam binnen een functie maakt die naam lokaal in de hele functie, tenzij een declaratie global of nonlocal van toepassing is. Dit geldt ook voor een toewijzing in een tak die nooit wordt uitgevoerd. In het voorbeeld moet count += 1 eerst de lokale count lezen; de modulebrede count = 10 wordt niet gebruikt. De uitzondering onderbreekt de aanroep en de modulebrede waarde blijft 10.
Los de oorzaak op: zorg dat vóór elke mogelijke leesbewerking een waarde is toegewezen, of geef de waarde mee als argument en retourneer het resultaat. Gebruik global als je een naam op moduleniveau opnieuw wilt binden; gebruik nonlocal voor een bestaande binding in de dichtstbijzijnde omringende functie. Plaats de declaratie vóór het gebruik van de naam. De uitzondering in het voorbeeld opvangen dient ter demonstratie en herstelt de scopefout niet.
Voorbeelden
count = 10
def increment():
count += 1
return count
try:
increment()
except UnboundLocalError as error:
print(type(error).__name__)
print(count)
Resultaat
UnboundLocalError 10
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.