WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

ValueError – ein unzulässiger Argumentwert

ValueError bedeutet, dass ein Argument den richtigen Typ, aber einen unzulässigen Wert hat. Erfahre, wie sich der Fehler von TypeError unterscheidet und wie du ihn auslöst und abfängst.

Version: 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 ist eine eingebaute Ausnahme, die ausgelöst wird, wenn eine Operation ein Argument mit dem richtigen Typ, aber einem ungeeigneten Wert erhält und kein spezifischerer Fehler, etwa IndexError, die Situation beschreibt. Ein ungeeigneter Argumenttyp wird dagegen durch TypeError angezeigt.

Verwende in deinem eigenen Code raise ValueError(message), um einen Wert zurückzuweisen, der die Anforderungen einer Funktion verletzt. Im Beispiel liegt die Zahl 120 außerhalb des zulässigen Prozentbereichs von einschließlich 0 bis 100. Die Funktion prüft den Wertebereich; sie führt keine vollständige Typvalidierung durch.

Fange einen erwarteten Fehler mit except ValueError as exc ab. Die Variable exc verweist auf das Ausnahmeobjekt, dessen Meldung du ausgeben kannst. Diese Klausel fängt auch Unterklassen von ValueError ab. Beschränke den try-Block auf die Operation, deren Fehler du behandeln möchtest, statt mit einer umfassenden Ausnahmebehandlung nicht zusammenhängende Fehler zu verbergen.

Das Beispiel löst die Ausnahme ausdrücklich aus und behandelt sie, daher gibt es die angegebene Meldung statt eines nicht abgefangenen Tracebacks aus. Die erwartete Ausgabe bestätigt nicht, dass ein Test ausgeführt wurde.

Beispiele

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}")

Ergebnis

ValueError: percentage must be between 0 and 100

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen