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.