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