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 関数からのreturn）に呼び出すために登録します。

同じ関数を複数回登録しても構いません。

関数が例外によって終了した場合、std::terminate が呼び出されます。

atexitはスレッドセーフです。複数のスレッドからこの関数を呼び出してもデータ競合は発生しません。

実装は、少なくとも32個の関数の登録をサポートすることが保証されています。正確な上限は実装定義です。

パラメータ

戻り値

​ 0 ​ 登録が成功した場合は0、それ以外の場合は0以外の値。

注記

これら2つのオーバーロードは区別されます。なぜなら、パラメータ 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

関連項目