Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje