std::atexit

 

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> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

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

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

Функции будут вызываться при уничтожении статических объектов в обратном порядке: если A была зарегистрирована до B, то вызов B выполняется до вызова A. То же самое относится к порядку между конструкторами статических объектов и вызовами atexit (смотрите std::exit)	(до C++11)
Функции могут быть вызваны конкурентно с деструкторами объектов со статической длительностью хранения и друг с другом, сохраняя гарантию того, что если регистрация A была произведена до регистрации B, то вызов B будет до вызова A, то же самое применимо для последовательности между конструкторами статических объектов и вызовами atexit (смотрите std::exit )	(начиная с C++11)

Одна и та же функция может быть зарегистрирована более одного раза.

Если функция завершается через исключение, вызывается std::terminate.

atexit является потокобезопасной: вызов функции из нескольких потоков не вызывает гонки данных.

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

Параметры

func

—

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

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

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

Примечание

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

Пример

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

#include <iostream>
#include <cstdlib>

void atexit_handler_1() 
{
    std::cout << "На выходе #1\n";
}

void atexit_handler_2() 
{
    std::cout << "На выходе #2\n";
}

int main() 
{
    const int result_1 = std::atexit(atexit_handler_1);
    const int result_2 = std::atexit(atexit_handler_2);

    if (result_1 or result_2)
    {
        std::cerr << "Регистрация не удалась!\n";
        return EXIT_FAILURE;
    }

    std::cout << "Возврат из main\n";
    return EXIT_SUCCESS;
}

Вывод:

Возврат из main
На выходе #2
На выходе #1

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

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