KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

ValueError — een ongeschikte argumentwaarde

ValueError betekent dat een argument het juiste type heeft, maar een onaanvaardbare waarde. Lees hoe dit verschilt van TypeError en hoe je deze uitzondering opwerpt en opvangt.

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

Syntax

# Pattern 1: Raise ValueError
raise ValueError(message)

# Pattern 2 (separate snippet): Catch ValueError from an operation
try:
    operation()
except ValueError as exc:
    handle(exc)

ValueError is een ingebouwde uitzondering die wordt opgewekt wanneer een bewerking een argument van het juiste type maar met een ongeschikte waarde ontvangt, en geen specifiekere uitzondering, zoals IndexError, de situatie beschrijft. Een ongeschikt argumenttype wordt juist aangegeven met TypeError.

Gebruik in je eigen code raise ValueError(message) om een waarde af te wijzen die niet voldoet aan de vereisten van een functie. In het voorbeeld valt het getal 120 buiten het toegestane percentagebereik van 0 tot en met 100. De functie controleert het bereik; dit is geen volledige typevalidatie.

Vang een verwachte fout op met except ValueError as exc. De variabele exc verwijst naar het uitzonderingsobject, waarvan je het bericht kunt afdrukken. Deze clausule vangt ook subklassen van ValueError op. Beperk het try-blok tot de bewerking waarvan je de fout wilt afhandelen, in plaats van niet-gerelateerde fouten te verbergen met een brede uitzonderingsafhandeling.

Het voorbeeld wekt de uitzondering expliciet op en handelt deze af, zodat het de opgegeven melding afdrukt in plaats van een niet-afgevangen traceback. De verwachte uitvoer bevestigt niet dat er een test is uitgevoerd.

Voorbeelden

def validate_percentage(value):
    if not 0 <= value <= 100:
        raise ValueError("percentage must be between 0 and 100")
    return value

try:
    validate_percentage(120)
except ValueError as exc:
    print(f"ValueError: {exc}")

Resultaat

ValueError: percentage must be between 0 and 100

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