std::exit

定义于头文件 `<cstdlib>`
void exit( int exit_code );		(C++11 前)
[[noreturn]] void exit( int exit_code );		(C++11 起)

导致正常程序终止发生。

进行一些清理步骤：

1) 以其动态初始化完成或构造函数完成的逆序，调用拥有静态存储期的对象的析构函数，并以注册的逆序（从尾到首）调用传递给 std::atexit 的函数。

a) 任何静态对象，之初始化完成先于 std::atexit 对某函数 F 调用者，将于程序终止期间后于 F 的调用销毁。

b) 任何静态对象，之初始化开始后于 std::atexit 对某函数 F 调用者，将于程序终止期间先于 F 的调用销毁（这包含从该静态对象的构造函数调用 std::atexit 的情况）。

(C++11 前)

1) 拥有关联到当前线程的线程局域存储期的对象的析构函数、拥有静态存储期的对象的析构函数及以 std::atexit 注册的函数并发执行，同时保持下列保证：

a) 线程局域对象的最末析构函数先序于静态对象的首个析构函数。

b) 若线程局域或静态对象 A 的构造函数或动态初始化完成先序于线程局域或静态对象 B ，则 B 的析构完成先序于 A 的析构开始。

c) 若静态对象 A 的初始化完成先序于 std::atexit 对某函数 F 的调用，则在终止期间到 F 的调用先序于 A 的析构开始。

d) 若 std::atexit 对某函数 F 的调用先序于静态对象 A 的初始化完成，则终止期间 A 的析构开始先序于 F 的调用。

e) 若 std::atexit 对某函数 F1 的调用先序于 std::atexit 对某函数 F2 的调用，则终止期间 F2 的调用先序于 F1 的调用。

(C++11 起)

以上内容中，

若任何以 atexit 注册的函数或任何静态/线程局域对象的析构函数抛出异常，则调用 std::terminate 。
若编译器将对象动态初始化提升到非局部初始化的静态初始化阶段，则析构顺序忠实于其本应有的动态初始化。
若函数局域（块作用域）静态对象被销毁，然后该函数从另一静态对象被调用，且控制流经过该对象的定义（或若它被间接使用，则是经过指针或引用），则行为未定义。
若函数局域（块作用域）静态对象在对象或数组的构造期间初始化，则仅在销毁该类的所有子对象或该数组的所有元素后才销毁它。

2) 冲入并关闭所有 C 流

3) 移除 std::tmpfile 所创建的文件

4) 将控制返回给宿主环境。若 exit_code 为 0 或 EXIT_SUCCESS ，则返回实现定义的指示成功终止的状态。若 exit_code 为 EXIT_FAILURE ，则返回实现定义的指示不成功终止的状态。任何其他情况下返回实现定义的状态值。

不回溯栈：不调用拥有自动存储期变量的析构函数。

与 main 函数的关系

从 main 函数以 return 语句或以抵达函数尾返回，会进行正常函数终止（调用拥有自动存储期的对象的析构函数），再执行 std::exit ，将 return 语句的参数（或若使用隐式 return 则为 0 ）作为 exit_code 传递。

参数

exit_code

-

程序的退出状态

返回值

（无）

示例

运行此代码

#include <iostream>
#include <cstdlib>
 
class Static {
public:
 
    ~Static() 
    {
        std::cout << "Static dtor\n";
    }
};
 
class Local {
public:
    ~Local() 
    {
        std::cout << "Local dtor\n";
    }
};
 
Static static_variable; // *将*调用此对象的析构函数
 
void atexit_handler()
{
    std::cout << "atexit handler\n";
}
 
int main()
{
    Local local_variable; // 将*不*调用此对象的析构函数
    const int result = std::atexit(atexit_handler); // 将调用处理函数
 
    if (result != 0) {
        std::cerr << "atexit registration failed\n";
        return EXIT_FAILURE;
    }
 
    std::cout << "test\n";
    std::exit(EXIT_FAILURE);
}

输出：

test
atexit handler
Static dtor

参阅

abort	导致非正常的程序终止（不进行清理） (函数)
atexit	注册将于调用 std::exit() 时被调用的函数 (函数)
quick_exit (C++11)	导致快速程序终止，不进行完全的清理 (函数)
at_quick_exit (C++11)	注册将于调用 `quick_exit` 时被调用的函数 (函数)

语言
标准库头文件
自立与有宿主实现
具名要求
语言支持库
概念库 (C++20)
诊断库
工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
输入/输出库
本地化库
正则表达式库 (C++11)
原子操作库 (C++11)
线程支持库 (C++11)
文件系统库 (C++17)
技术规范

std::exit

与 main 函数的关系

参数

返回值

示例

参阅

导航