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 调用时调用的函数 (函数)
C++ 文档 为 atexit