CKTIS / Python
AssertionError — mislukte assertion
AssertionError is een ingebouwde uitzondering die wordt opgegooid wanneer de voorwaarde van een assert-instructie onwaar is. Assertions controleren interne aannames van het programma en zijn niet bedoeld voor verplichte invoervalidatie: optimalisatie kan ze verwijderen.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
assert condition
assert condition, message
raise AssertionError(message)AssertionError is een ingebouwde uitzonderingsklasse die is afgeleid van Exception. Wanneer assertions zijn ingeschakeld, controleert assert condition de waarheidswaarde van de voorwaarde en wordt AssertionError opgegooid als deze onwaar is. De vorm assert condition, message geeft de waarde van message door aan de constructor van de uitzondering; de berichtexpressie wordt alleen geëvalueerd als niet aan de voorwaarde wordt voldaan.
Een assertion verwoordt een aanname van de programmeur over de interne toestand van het programma. In het voorbeeld neemt first_item aan dat de lijst niet leeg is. De aanroep met [] schendt die aanname, en except AssertionError as exc vangt de uitzondering op en drukt het type en bericht ervan af. Opvangen dient hier om de uitzondering te demonstreren, niet om de oorzaak ervan te verhelpen.
Gebruik assert niet voor verplichte validatie van gebruikersinvoer of voor machtigingscontroles. Bij optimalisatie, bijvoorbeeld met -O, worden assert-instructies overgeslagen: noch de voorwaarde, noch het bericht wordt geëvalueerd. Plaats er geen bewerkingen in die nodig zijn om het programma te laten werken. Schrijf verplichte controles met if en een expliciete raise, en kies een passende uitzondering, zoals ValueError voor een ongeschikte argumentwaarde.
Je kunt ook expliciet raise AssertionError(message) uitvoeren; die instructie wordt niet verwijderd door optimalisatie. Onderzoek bij het opsporen van de fout de geschonden aanname en de code die de onverwachte toestand heeft veroorzaakt, in plaats van alleen de assertion te verwijderen.
Voorbeelden
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))Resultaat
AssertionError items must not be empty
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.