CKTIS / Python
ValueError — nevhodná hodnota argumentu
ValueError označuje, že argument má správny typ, ale neprijateľnú hodnotu. Zistite, ako sa líši od TypeError a ako túto výnimku vyvolať a zachytiť.
Verzia: 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 je vstavaná výnimka, ktorá sa vyvolá, keď operácia dostane argument správneho typu, ale s nevhodnou hodnotou, a situáciu nepopisuje konkrétnejšia výnimka, napríklad IndexError. Nevhodný typ argumentu naopak signalizuje TypeError.
Vo vlastnom kóde použite raise ValueError(message), ak chcete odmietnuť hodnotu, ktorá nespĺňa požiadavky funkcie. V príklade je číslo 120 mimo povoleného percentuálneho rozsahu od 0 do 100 vrátane. Funkcia kontroluje rozsah; nejde o úplnú kontrolu typov.
Očakávanú chybu zachyťte pomocou except ValueError as exc. Premenná exc odkazuje na objekt výnimky, ktorého správu môžete vypísať. Táto klauzula zachytí aj podtriedy ValueError. Blok try obmedzte na operáciu, ktorej chybu chcete spracovať, namiesto toho, aby ste širokým zachytávaním výnimiek skrývali nesúvisiace chyby.
Príklad výnimku výslovne vyvolá a spracuje, takže vypíše zadanú správu namiesto neošetreného tracebacku. Očakávaný výstup nepotvrdzuje, že bol test spustený.
Prí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ýsledok
ValueError: percentage must be between 0 and 100
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.