atexit

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

プログラムサポートユーティリティ

プログラムの終了
abort exit quick_exit (C11) _Exit (C99)	atexit at_quick_exit (C11) EXIT_SUCCESSEXIT_FAILURE
到達不能な制御フロー
unreachable (C23)
環境との通信
getenvgetenv_s (C11)	system
メモリアライメントの問い合わせ
memalignment (C23)
シグナル
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
シグナルの種類
SIGABRTSIGFPESIGILL	SIGINTSIGSEGVSIGTERM
非局所ジャンプ
setjmp	longjmp
型
jmp_buf

 

ヘッダー <stdlib.h> で定義
int atexit( void (*func)(void) );

funcが指す関数を、通常のプログラム終了時（exit()による終了、またはmain()からの復帰）に呼び出されるように登録します。関数は登録された逆順で呼び出されます。つまり、最後に登録された関数が最初に実行されます。

同じ関数を複数回登録することも可能です。

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

パラメータ

func

-

通常のプログラム終了時に呼び出される関数へのポインタ

戻り値

登録が成功した場合は​0​、それ以外の場合はゼロ以外の値を返します。

例

このコードを実行

#include <stdlib.h>
#include <stdio.h>
 
void f1(void)
{
    puts("f1");
}
 
void f2(void)
{
    puts("f2");
}
 
int main(void)
{
    if ( ! atexit(f1) && ! atexit(f2) && ! atexit(f2) )
        return EXIT_SUCCESS ;
 
    // atexit registration failed
    return EXIT_FAILURE ;
 
}   // <- if registration was successful calls f2, f2, f1

出力

f2
f2
f1

参考文献

• C17標準 (ISO/IEC 9899:2018)

• 7.22.4.2 The atexit function (p: 255)

• C11標準 (ISO/IEC 9899:2011)

• 7.22.4.2 The atexit function (p: 350)

• C99標準 (ISO/IEC 9899:1999)

• 7.20.4.2 The atexit function (p: 315)

• C89/C90標準 (ISO/IEC 9899:1990)

• 7.10.4.2 The atexit function (p: 156)

関連項目

at_quick_exit (C11)	quick_exit の呼び出し時に呼ばれる関数を登録する (関数)
C++ ドキュメント for atexit