_Noreturn 函数说明符 (C11 起)(C23 已弃用)

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

C 语言

基本概念

关键词

预处理器

语句

表达式

初始化

声明

函数

杂项

C 的历史

技术规范

 

函数

函数声明

函数定义

可变参数

inline (C99)

_Noreturn (C11)

 

指定函数不会返回到其调用点。

语法

_Noreturn 函数声明		(C11 起)(C23 已弃用)

解释

_Noreturn 关键字出现在函数声明中，并指定函数不会通过执行 return 语句或到达函数体末尾而返回（它可以通过执行 longjmp 返回）。如果声明为 _Noreturn 的函数返回，则行为未定义。如果可以检测到这种情况，建议编译器进行诊断。

_Noreturn 说明符可以在同一个函数声明中出现多次，其行为与出现一次相同。

此说明符通常通过便利宏 noreturn 使用，该宏在头文件 <stdnoreturn.h> 中提供。

_Noreturn 函数说明符已弃用。应改用 [[noreturn]] 属性。 宏 noreturn 也已弃用。

(自 C23 起)

关键字

_Noreturn

标准库

以下函数在标准库中是 noreturn 的

• abort()
• exit()
• _Exit()
• quick_exit()
• thrd_exit()
• longjmp()

示例

运行此代码

#include <stdio.h>
#include <stdlib.h>
#include <stdnoreturn.h>
 
// causes undefined behavior if i <= 0
// exits if i > 0
noreturn void exit_now(int i) // or _Noreturn void exit_now(int i)
{
    if (i > 0)
        exit(i);
}
 
int main(void)
{
    puts("Preparing to exit...");
    exit_now(2);
    puts("This code is never executed.");
}

输出

Preparing to exit...

参考文献

• C23 标准 (ISO/IEC 9899:2024)

• 6.7.4 函数说明符 (p: 待定)

• 7.23 _Noreturn <stdnoreturn.h> (p: 待定)

• C17 标准 (ISO/IEC 9899:2018)

• 6.7.4 函数说明符 (p: 90-91)

• 7.23 _Noreturn <stdnoreturn.h> (p: 263)

• C11 标准 (ISO/IEC 9899:2011)

• 6.7.4 函数说明符 (p: 125-127)

• 7.23 _Noreturn <stdnoreturn.h> (p: 361)

另请参阅

[[noreturn]](C23)[[_Noreturn]](C23)(已弃用) {{{注释}}}	指示函数不返回 (属性说明符)
C++ 文档 关于 [[noreturn]]