std::atexit

int atexit( /*c-atexit-handler*/* func );
int atexit( /*atexit-handler*/* func );

int atexit( /*c-atexit-handler*/* func ) noexcept;
int atexit( /*atexit-handler*/* func ) noexcept;

extern "C" using /*c-atexit-handler*/ = void();
extern "C++" using /*atexit-handler*/ = void();

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

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

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

atexitthread-safe: вызов функции из нескольких потоков не вызывает состояния гонки (data race).

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

Параметры

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

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

Примечания

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

Пример

#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

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