База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

AssertionError — неуспешна проверка с твърдение

AssertionError е вградено изключение, което се повдига, когато условието на оператор assert е невярно. Твърденията проверяват вътрешни предположения на програмата, а не служат за задължителна проверка на входни данни: оптимизацията може да ги премахне.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

assert condition
assert condition, message
raise AssertionError(message)

AssertionError е вграден клас изключение, наследяващ Exception. Когато твърденията са активирани, assert condition проверява логическата стойност на условието и повдига AssertionError, ако то е невярно. Формата assert condition, message подава стойността на message към конструктора на изключението; изразът на съобщението се оценява само ако условието не е изпълнено.

Твърдението изразява предположение на програмиста за вътрешното състояние на програмата. В примера first_item приема, че списъкът не е празен. Извикването с [] нарушава това предположение, а except AssertionError as exc прихваща изключението и извежда неговия тип и съобщение. Тук прихващането служи за демонстрация на изключението, а не за отстраняване на причината му.

Не използвайте assert за задължителна проверка на потребителски входни данни или права за достъп. При оптимизация, например с -O, операторите assert се пропускат: не се оценяват нито условието, нито съобщението. Не поставяйте в тях операции, необходими за работата на програмата. Записвайте задължителните проверки с if и изричен raise, като изберете подходящо изключение, например ValueError за неподходяща стойност на аргумент.

Можете също изрично да изпълните raise AssertionError(message); оптимизацията не премахва този оператор. Когато диагностицирате грешката, проверете нарушеното предположение и кода, довел до неочакваното състояние, вместо просто да премахнете твърдението.

Примери

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

Резултат

AssertionError
items must not be empty

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници