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

CKTIS / Python

AssertionError — neúspěšné tvrzení

AssertionError je vestavěná výjimka, která se vyvolá, když je podmínka příkazu assert nepravdivá. Tvrzení kontrolují interní předpoklady programu, neslouží k povinné validaci vstupů: optimalizace je může odstranit.

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

Syntaxe

assert condition
assert condition, message
raise AssertionError(message)

AssertionError je vestavěná třída výjimky odvozená od Exception. Když jsou tvrzení povolena, assert condition ověří pravdivostní hodnotu podmínky a při její nepravdivosti vyvolá AssertionError. Tvar assert condition, message předá hodnotu message konstruktoru výjimky; výraz zprávy se vyhodnotí pouze tehdy, když podmínka není splněna.

Tvrzení vyjadřuje předpoklad programátora o interním stavu programu. V příkladu first_item předpokládá, že seznam není prázdný. Volání s [] tento předpoklad poruší a except AssertionError as exc výjimku zachytí a vypíše její typ a zprávu. Zachycení zde slouží k předvedení výjimky, nikoli k nápravě její příčiny.

Nepoužívejte assert pro povinnou validaci uživatelských vstupů ani kontrolu oprávnění. Při optimalizaci, například pomocí -O, se příkazy assert vynechají: nevyhodnotí se podmínka ani zpráva. Neumisťujte do nich operace nezbytné pro fungování programu. Povinné kontroly zapisujte pomocí if s výslovným raise a zvolte vhodnou výjimku, například ValueError pro nevhodnou hodnotu argumentu.

Můžete také výslovně provést raise AssertionError(message); tento příkaz se optimalizací neodstraní. Při diagnostice chyby prověřte porušený předpoklad a kód, který vytvořil neočekávaný stav, místo pouhého odstranění tvrzení.

Příklady

def first_item(items):
    assert len(items) > 0, "items must not be empty"
    return items[0]

try:
    first_item([])
except AssertionError as exc:
    print(type(exc).__name__)
    print(str(exc))

Výsledek

AssertionError
items must not be empty

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