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)

 

Определено в заголовочном файле <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";throwstd::runtime_error("тестовое исключение");}catch(conststd::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)