Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

ValueError — nieprawidłowa wartość argumentu

ValueError oznacza, że argument ma właściwy typ, ale niedopuszczalną wartość. Poznaj różnicę względem TypeError oraz sposób zgłaszania i przechwytywania tego wyjątku.

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

Składnia

# 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 to wbudowany wyjątek zgłaszany, gdy operacja otrzymuje argument właściwego typu, lecz o nieodpowiedniej wartości, a sytuacji nie opisuje dokładniejszy wyjątek, np. IndexError. Niewłaściwy typ argumentu sygnalizuje natomiast TypeError.

We własnym kodzie używaj raise ValueError(message), aby odrzucić wartość naruszającą wymagania funkcji. W przykładzie liczba 120 jest poza dozwolonym zakresem procentowym od 0 do 100 włącznie. Funkcja sprawdza zakres; nie jest to pełna walidacja typów.

Przechwytuj oczekiwany błąd przez except ValueError as exc. Zmienna exc wskazuje obiekt wyjątku, który można wypisać, aby uzyskać komunikat. Taka klauzula przechwytuje również podklasy ValueError. Ogranicz blok try do operacji, której błąd chcesz obsłużyć, zamiast ukrywać niepowiązane błędy szerokim przechwytywaniem.

Przykład jawnie zgłasza wyjątek i obsługuje go, dlatego wypisuje podany komunikat zamiast nieobsłużonego tracebacku. Oczekiwany wynik nie jest potwierdzeniem wykonania testu.

Przykłady

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

Wynik

ValueError: percentage must be between 0 and 100

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła