_onexit, _onexit_m
終了時に呼び出されるルーチンを登録します。
構文
_onexit_t _onexit(
_onexit_t function
);
_onexit_t_m _onexit_m(
_onexit_t_m function
);
パラメーター
function
終了時に呼び出される関数へのポインター。
戻り値
_onexit は、成功した場合は関数へのポインターを返し、関数ポインターを格納するスペースがない場合は NULL します。
解説
_onexit 関数には、プログラムが正常に終了したときに呼び出される関数 (function) のアドレスが渡されます。 _onexit を連続して呼び出すと、LIFO (後入先出法) 順で実行される関数のレジスタが作成されます。 _onexitに渡される関数はパラメーターを受け取ることはできません。
_onexitに登録されたルーチンは、DLL_PROCESS_DETACHでDllMainが呼び出された後、DLL がアンロードされたときに実行されます。
_onexit は Microsoft 拡張機能です。 ANSI 移植性を実現するには、 atexitを使用します。 _onexit_m バージョンの関数は、混在モード用です。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
_onexit |
<stdlib.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
// crt_onexit.c
#include <stdlib.h>
#include <stdio.h>
/* Prototypes */
int fn1(void), fn2(void), fn3(void), fn4 (void);
int main( void )
{
_onexit( fn1 );
_onexit( fn2 );
_onexit( fn3 );
_onexit( fn4 );
printf( "This is executed first.\n" );
}
int fn1()
{
printf( "next.\n" );
return 0;
}
int fn2()
{
printf( "executed " );
return 0;
}
int fn3()
{
printf( "is " );
return 0;
}
int fn4()
{
printf( "This " );
return 0;
}
出力
This is executed first.
This is executed next.