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 atexit 函式 (p: 255)

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

• 7.22.4.2 atexit 函式 (p: 350)

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

• 7.20.4.2 atexit 函式 (p: 315)

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

• 7.10.4.2 atexit 函式 (p: 156)

參閱

at_quick_exit (C11)	註冊一個函式，以便在呼叫 quick_exit 時被呼叫 (function)
C++ 文件 關於 atexit