std::at_quick_exit

 

C++

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

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

Язык

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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

Языковая поддержка Поддержка типов (базовые типы, RTTI) Макросы тестирования функциональности библиотеки (C++20)     Управление динамической памятью Программные утилиты Поддержка сопрограмм (C++20) Вариативные функции is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Трёхстороннее сравнение (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)     is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

Общие утилиты Дата и время Функциональные объекты Библиотека форматирования (C++20) bitset hash (C++11) Операторы отношения (устарело в C++20) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= Целочисленные функции сравнения cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)     cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Операции обмена и типа swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Общие лексические типы pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) Элементарные преобразования строк to_chars (C++17) from_chars (C++17) chars_format (C++17) to_chars_result (C++17) from_chars_result (C++17)

 

Утилиты поддержки программ

Прерывание программы
abort exit quick_exit (C++11) _Exit (C++11)	atexit at_quick_exit (C++11) EXIT_SUCCESSEXIT_FAILURE
Недостижимый поток управления
unreachable (C++23)
Взаимодействие с окружением
system	getenv
Сигналы
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
Типы сигналов
SIGABRTSIGFPESIGILL	SIGINTSIGSEGVSIGTERM
Нелокальные переходы
setjmp	longjmp
Типы
jmp_buf

 

<tbody> </tbody>

Определено в заголовочном файле <cstdlib>
int at_quick_exit( /*atexit-обработчик*/* func ) noexcept; int at_quick_exit( /*c-atexit-обработчик*/* func ) noexcept;	(1)	(начиная с C++11)
extern "C++" using /*atexit-обработчик*/ = void(); extern "C" using /*c-atexit-обработчик*/ = void();	(2)	(только для пояснения*)

Регистрирует указатель на функцию func для того, чтобы она была вызвана при быстром завершении программы (с помощью std::quick_exit).

Вызов этой функции из нескольких потоков не приведёт к гонке данных. Реализация гарантированно поддерживает регистрацию не менее 32 функций. Точный предел определяется реализацией.

Зарегистрированные функции не будут вызваны при обычном завершении программы. Чтобы они были вызваны в этом случае, нужно воспользоваться std::atexit.

Параметры

func

—

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

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

0, если регистрация прошла успешно, иначе ненулевое значение.

Примечание

Две перегрузки различны, потому что типы параметра func различны (языковое связывание является частью его типа)

Пример

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

#include <cstdlib>
#include <iostream>

void f1()
{
    std::cout << "назначена первой" << std::endl; // принудительный сброс
}

extern "C" void f2()
{
    std::cout << "назначена второй\n";
}

int main()
{
    auto f3 = []
    {
        std::cout << "назначена третьей\n";
    };

    std::at_quick_exit(f1);
    std::at_quick_exit(f2);
    std::at_quick_exit(f3);
    std::quick_exit(0);
}

Вывод:

назначена третьей
назначена второй
назначена первой

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

abort	вызывает аварийное завершение программы (без очистки) (функция)
exit	вызывает нормальное завершение программы с очисткой (функция)
atexit	регистрирует функцию, которая будет вызываться при вызове std::exit() (функция)
quick_exit (C++11)	вызывает быстрое завершение программы без полной очистки (функция)
Документация C по at_quick_exit