CKTIS / Python
ValueError — nevhodná hodnota argumentu
ValueError označuje, že argument má správný typ, ale nepřijatelnou hodnotu. Zjistěte, jak se liší od TypeError a jak tuto výjimku vyvolat a zachytit.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
# 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 je vestavěná výjimka, která se vyvolá, když operace obdrží argument správného typu, ale s nevhodnou hodnotou, a situaci nepopisuje konkrétnější výjimka, například IndexError. Nevhodný typ argumentu naopak signalizuje TypeError.
Ve vlastním kódu použijte raise ValueError(message), chcete-li odmítnout hodnotu, která nesplňuje požadavky funkce. V příkladu je číslo 120 mimo povolený procentní rozsah od 0 do 100 včetně. Funkce kontroluje rozsah; nejde o úplnou kontrolu typů.
Očekávanou chybu zachyťte pomocí except ValueError as exc. Proměnná exc odkazuje na objekt výjimky, jehož zprávu můžete vypsat. Tato klauzule zachytí také podtřídy ValueError. Blok try omezte na operaci, jejíž chybu chcete zpracovat, místo abyste širokým zachytáváním výjimek skrývali nesouvisející chyby.
Příklad výjimku výslovně vyvolá a zpracuje, takže vypíše zadanou zprávu namísto neošetřeného tracebacku. Očekávaný výstup nepotvrzuje, že byl test spuštěn.
Příklady
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}")Výsledek
ValueError: percentage must be between 0 and 100
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.