Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Python

AssertionError — neuspešna trditev

AssertionError je vgrajena izjema, ki se sproži, kadar je pogoj stavka assert neresničen. Trditve preverjajo notranje predpostavke programa in niso namenjene obveznemu preverjanju vhodnih podatkov: optimizacija jih lahko odstrani.

Različica: Python 3.14; repository image, production runtime not attested

Sintaksa

assert condition
assert condition, message
raise AssertionError(message)

AssertionError je vgrajeni razred izjeme, izpeljan iz Exception. Ko so trditve omogočene, assert condition preveri logično vrednost pogoja in sproži AssertionError, če je pogoj neresničen. Oblika assert condition, message posreduje vrednost message konstruktorju izjeme; izraz sporočila se ovrednoti samo, če pogoj ni izpolnjen.

Trditev izraža programerjevo predpostavko o notranjem stanju programa. V primeru first_item predpostavlja, da seznam ni prazen. Klic z [] krši to predpostavko, except AssertionError as exc pa izjemo prestreže in izpiše njen tip ter sporočilo. Prestrezanje je tu namenjeno prikazu izjeme, ne odpravi njenega vzroka.

assert ne uporabljajte za obvezno preverjanje uporabniških vhodnih podatkov ali dovoljenj. Pri optimizaciji, na primer z -O, se stavki assert izpustijo: ne ovrednotita se ne pogoj ne sporočilo. Vanje ne vključujte operacij, ki so nujne za delovanje programa. Obvezna preverjanja zapišite z if in izrecnim raise ter izberite ustrezno izjemo, na primer ValueError za neustrezno vrednost argumenta.

Izrecno lahko izvedete tudi raise AssertionError(message); optimizacija tega stavka ne odstrani. Pri diagnosticiranju napake preverite kršeno predpostavko in kodo, ki je ustvarila nepričakovano stanje, namesto da zgolj odstranite trditev.

Primeri

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))

Rezultat

AssertionError
items must not be empty

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri