CKTIS / Python
AssertionError — fehlgeschlagene Assertion
AssertionError ist eine eingebaute Ausnahme, die ausgelöst wird, wenn die Bedingung einer assert-Anweisung falsch ist. Assertions prüfen interne Annahmen des Programms und dienen nicht der zwingenden Eingabevalidierung: Durch Optimierung können sie entfernt werden.
Version: Python 3.14; repository image, production runtime not attested
Syntax
assert condition
assert condition, message
raise AssertionError(message)AssertionError ist eine eingebaute Ausnahmeklasse, die von Exception abgeleitet ist. Wenn Assertions aktiviert sind, prüft assert condition den Wahrheitswert der Bedingung und löst AssertionError aus, wenn sie falsch ist. Die Form assert condition, message übergibt den Wert von message an den Ausnahmekonstruktor; der Nachrichtenausdruck wird nur ausgewertet, wenn die Bedingung nicht erfüllt ist.
Eine Assertion beschreibt eine Annahme der programmierenden Person über den internen Zustand des Programms. Im Beispiel geht first_item davon aus, dass die Liste nicht leer ist. Der Aufruf mit [] verletzt diese Annahme, und except AssertionError as exc fängt die Ausnahme ab und gibt ihren Typ und ihre Nachricht aus. Das Abfangen dient hier der Veranschaulichung der Ausnahme, nicht der Behebung ihrer Ursache.
Verwende assert nicht für zwingende Eingabevalidierung oder Berechtigungsprüfungen. Bei aktivierter Optimierung, etwa mit -O, werden assert-Anweisungen ausgelassen: Weder die Bedingung noch die Nachricht wird ausgewertet. Führe darin keine Vorgänge aus, die für die Funktion des Programms erforderlich sind. Schreibe notwendige Prüfungen mit if und einem expliziten raise und wähle eine passende Ausnahme, zum Beispiel ValueError bei einem ungeeigneten Argumentwert.
Du kannst auch ausdrücklich raise AssertionError(message) ausführen; diese Anweisung wird durch Optimierung nicht entfernt. Untersuche bei der Fehlersuche die verletzte Annahme und den Code, der den unerwarteten Zustand erzeugt hat, statt lediglich die Assertion zu löschen.
Beispiele
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))Ergebnis
AssertionError items must not be empty
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.