std::uncaught_exception, std::uncaught_exceptions

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека диагностики

Обработка исключений exception uncaught_exceptionuncaught_exceptions (до C++20*)(C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) Сбои обработки исключений terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (до C++17*) unexpected_handler (до C++17*) get_unexpected (C++11)(до C++17*)     set_unexpected (до C++17*) Коды ошибок Коды ошибок errno

Категории исключений logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (ТС TM) Поддержка системных ошибок error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) Утверждения assert Трассировка стека stacktrace_entry (C++23) basic_stacktrace (C++23)

 

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

Определено в заголовочном файле <exception>
	(1)
bool uncaught_exception() throw();			(до C++11)
bool uncaught_exception() noexcept;			(начиная с C++11) (устарело в C++17) (удалено в C++20)
int uncaught_exceptions() noexcept;		(2)	(начиная с C++17)

1) Определяет, есть ли в текущем потоке активный объект исключения, т.е. исключение было сгенерировано или повторно сгенерировано и ещё управление не вошло в соответствующее предложение catch, std::terminate или std::unexpected. Другими словами, std::uncaught_exception определяет, выполняется ли в данный момент раскручивание стека.

2) Определяет, сколько исключений в текущем потоке было сгенерировано или повторно сгенерировано, и которые ещё не вошли в соответствующие им предложения catch.

Иногда генерировать исключение безопасно, даже если std::uncaught_exception() == true. Например, если раскручивание стека приводит к уничтожению объекта, деструктор для этого объекта может запускать код, который генерирует исключение, если исключение перехватывается каким-либо блоком catch перед выходом из деструктора.

Параметры

(нет)

Возвращаемое значение

1) true, если в данный момент в этом потоке выполняется раскручивание стека, иначе false.

2) Количество неперехваченных объектов исключений в текущем потоке.

Примечание

Примером, где используется возвращающая int uncaught_exceptions, является библиотека boost.log: выражение BOOST_LOG(logger) << foo(); сначала создаёт защищающий объект и записывает количество неперехваченных исключений в своём конструкторе. Вывод выполняется деструктором защищающего объекта, если только foo() не генерирует исключение (в этом случае количество неперехваченных исключений в деструкторе больше, чем наблюдаемое конструктором).

std::experimental::scope_fail и std::experimental::scope_success в LFTS v3 полагаются на функциональность uncaught_exceptions, потому что их деструкторы должны делать разные действия, которые зависят от того, вызываются ли они во время раскручивания стека.

Макрос Тестирования функциональности	Значение	Стандарт	Функциональность
__cpp_lib_uncaught_exceptions	201411L	(C++17)	std::uncaught_exceptions

Пример

Запустить этот код

#include <exception>
#include <iostream>
#include <stdexcept>

struct Foo
{
    char id{'?'};
    int count = std::uncaught_exceptions();

    ~Foo()
    {
        count == std::uncaught_exceptions()
            ? std::cout << id << ".~Foo() вызван нормально\n"
            : std::cout << id << ".~Foo() вызван во время раскручивания стека\n";
    }
};

int main()
{
    Foo f{'f'};

    try
    {
        Foo g{'g'};
        std::cout << "Сгенерировано исключение\n";
        throw std::runtime_error("тестовое исключение");
    }
    catch (const std::exception& e)
    {
        std::cout << "Исключение поймано: " << e.what() << '\n';
    }
}

Возможный вывод:

Сгенерировано исключение
g.~Foo() вызван во время раскручивания стека
Исключение поймано: тестовое исключение
f.~Foo() вызван нормально

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 70	C++98	спецификация исключения uncaught_exception() отсутствовала	указывается как throw()

Смотрите также

terminate	функция, вызываемая при сбое обработки исключения (функция)
exception_ptr (C++11)	тип общего указателя для обработки объектов исключений (определение типа)
current_exception (C++11)	фиксирует текущее исключение в std::exception_ptr (функция)

Внешние ссылки

1.	Проблема GOTW 47: Неперехваченные Исключения
2.	Обоснование std::uncaught_exceptions (N4125)