std::atexit

Defined in header `<cstdlib>`
	(1)
int atexit( /* c-atexit-handler / func ); int atexit( /* atexit-handler / func );		(до C++11)
int atexit( /* c-atexit-handler / func ) noexcept; int atexit( /* atexit-handler / func ) noexcept;		(с C++11)
extern "C" using /* c-atexit-handler / = void(); extern "C++" using / atexit-handler */ = 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 <cstdlib>
#include <iostream>
 
void atexit_handler_1()
{
    std::cout << "At exit #1\n";
}
 
void atexit_handler_2()
{
    std::cout << "At exit #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 || result_2)
    {
        std::cerr << "Registration failed!\n";
        return EXIT_FAILURE;
    }
 
    std::cout << "Returning from main...\n";
    return EXIT_SUCCESS;
}

Вывод:

Returning from main...
At exit #2
At exit #1

См. также

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

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/utility/program/atexit