KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

NameError — verwijzing naar een niet-gedefinieerde naam

NameError betekent dat Python een gebruikte naam niet kon vinden in de beschikbare scopes. Controleer de spelling, de volgorde van toekenningen en imports. Onderscheid NameError van AttributeError. UnboundLocalError is een subklasse van NameError.

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

Syntax

try:
    ...
except NameError as exc:
    ...

NameError treedt tijdens de uitvoering op wanneer Python een gebruikte naam niet kan vinden in de beschikbare scopes. Dit geldt voor niet-gekwalificeerde namen, zoals total. Als een object obj bestaat maar geen attribuut value heeft, veroorzaakt de mislukte verwijzing obj.value normaal gesproken AttributeError, niet NameError.

Controleer de spelling en of de toekenning of import waarmee de naam wordt gebonden, is uitgevoerd voordat de naam wordt gebruikt. Controleer ook of de naam zichtbaar is in de huidige scope. Een toekenning die later in het bestand staat, maakt de waarde niet beschikbaar voor code die eerder wordt uitgevoerd.

UnboundLocalError is een subklasse van NameError: deze treedt op wanneer een lokale variabele in een functie of methode wordt gelezen voordat er een waarde aan is gebonden. Een toekenning aan een naam ergens in het functieblok kan ervoor zorgen dat die naam als lokaal wordt behandeld. Daarom vangt except NameError ook UnboundLocalError op.

In het voorbeeld is ttoal een typefout van total. Het except-blok drukt het type van de uitzondering en het attribuut name af; daarna drukt het programma de juiste waarde af. Het opvangen van de uitzondering probeert de mislukte expressie niet opnieuw. Los in gewone code de oorzaak op in plaats van de fout te verbergen met een te brede uitzonderingsafhandeling.

Voorbeelden

total = 12
try:
    print(ttoal)
except NameError as exc:
    print(type(exc).__name__)
    print(exc.name)
print(total)

Resultaat

NameError
ttoal
12

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.

Bronnen