名称

atexit — 終了時に呼び出される関数を登録する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < stdlib.h>

int
atexit( void (*function)(void));

解説

atexit() 関数は、 exit(3) によってであろうと、プログラムの main() から返ることによってであろうとプログラムの終了時に呼び出される与えられた function を登録します。登録された関数、逆の順序で呼び出されます。引数は、渡されません。

これらの関数は、 exit() を呼び出してはいけません。そのような関数の間でプロセスを終了することが必要であるなら、 _exit(2) 関数が使用されるべきです。 (もう 1 つの方法として、関数は、例えば abort(3) を呼び出すことによって、異常なプロセスの終了を引き起こすかもしれません。)

少なくとも 32 個の関数を常に登録することができ、十分なメモリを割り付けることができる限り、より多くが許可されます。

戻り値

The atexit() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

[ ENOMEM]

関数をリストに追加するためのメモリが利用可能ではありませんでした。機能の既存のリストは、未修正です。

関連項目

at_quick_exit(3) exit(3)

規格

atexit() 関数は、 ISO/IEC 9899:1990 (“ISO C90”) に適合しています。