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();

Registra la función apuntada por func para que sea llamada en la terminación normal del programa (mediante std::exit() o al retornar de la función main)

La misma función puede ser registrada más de una vez.

Si una función termina mediante una excepción, se llama a std::terminate.

atexit es segura para hilos: llamar a la función desde varios hilos no induce una condición de carrera.

Se garantiza que la implementación soporta el registro de al menos 32 funciones. El límite exacto está definido por la implementación.

Parámetros

Valor de retorno

​ 0 ​ si el registro tiene éxito, valor distinto de cero en caso contrario.

Notas

Las dos sobrecargas son distintas porque los tipos del parámetro func son distintos (el language linkage es parte de su tipo).

Ejemplo

#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

Véase también