Что такое функция raise в Python?

Ключевое слово raise в Python используется для генерации исключений, позволяя разработчикам явно указывать на возникновение ошибки в программе. Это инструмент, который делает код более надёжным и удобным в отладке, так как он позволяет предотвратить дальнейшее выполнение программы при обнаружении условий, которые она не способна корректно обработать.

Синтаксис: raise Exception("Сообщение об ошибке"),

где Exception — это тип исключения (можно использовать как встроенные типы исключений, так и определённые пользователем), а "Сообщение об ошибке" — строка, описывающая ошибку.

Примеры использования:

• Проверка корректности входных данных:

def set_age(age): 
    if age < 0: 
        raise ValueError("Возраст не может быть отрицательным")

• Сигнализация о невозможности выполнения операции:

def divide(a, b):
    if b == 0:
        raise ZeroDivisionError("Делитель не может быть равен нулю")
    return a / b

• Указание на ошибки в логике программы:

def calculate_square_root(number):
    if number < 0:
        raise ValueError("Невозможно вычислить квадратный корень из отрицательного числа")

Ключевое слово raise в Python используется для генерации исключений в программе. Как правило, она вызывается в случае возникновения ошибки или неожиданной ситуации, когда нужно прервать выполнение программы и передать информацию об ошибке обратно пользователю или программе.

raise принимает один или два аргумента. Первый аргумент - это тип исключения, которое нужно сгенерировать, это может быть стандартный класс исключения из встроенных модулей Python, таких как ValueError, TypeError, KeyError и другие, или пользовательский класс исключения. Второй аргумент - необязательный, это дополнительное сообщение об ошибке, которое можно передать при генерации исключения.

def divide(a, b):
    if b == 0:
        raise ZeroDivisionError("Деление на ноль недопустимо")
    return a / b

try:
    result = divide(10, 0)
except ZeroDivisionError as e:
    print("Ошибка:", e)

# => Ошибка: Деление на ноль недопустимо

raise — оператор, который выбрасывает исключение и прерывает выполнение функции. Скобки после него не нужны, это ключевое слово языка:

def set_age(age):
    if age < 0:
        raise ValueError('Возраст не может быть отрицательным')
    return age

set_age(-5)
# ValueError: Возраст не может быть отрицательным

Программа остановится, если исключение никто не перехватит.

Перехват через try / except

try:
    set_age(-5)
except ValueError as e:
    print(f'Ошибка: {e}')
# Ошибка: Возраст не может быть отрицательным

Какое исключение выбрасывать

Своё исключение

class InsufficientFundsError(Exception):
    pass

def withdraw(balance, amount):
    if amount > balance:
        raise InsufficientFundsError(f'На счёте {balance}, нужно {amount}')
    return balance - amount

Своё исключение наследуют от Exception. Так вызывающий код может перехватить именно его.

raise без аргументов

Внутри except пробрасывает пойманное исключение дальше. Удобно, чтобы записать ошибку в лог и не скрыть её:

try:
    withdraw(100, 500)
except InsufficientFundsError:
    print('Записали в лог')
    raise

raise ... from

Заменить одно исключение другим и сохранить исходную причину:

try:
    int('abc')
except ValueError as e:
    raise RuntimeError('Не удалось прочитать конфиг') from e

В трейсбеке будут оба исключения.

raise и assert

assert проверяет условия при отладке. Python с флагом -O пропускает все assert. Для проверки входных данных используйте raise.

Исключения разбирают в бесплатном курсе «Основы Python».