_Noreturn 函数说明符

 

C

编译器支持

语言

头文件

类型支持

程序实用程序

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用程序

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

C 语言

基本概念

关键字

预处理器

语句

表达式

初始化

声明

函数

其他

C 语言历史

技术规范

 

函数

函数声明

函数定义

可变参数

内联 (C99)

_Noreturn (C11)

 

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

语法

_Noreturn function_declaration		(自 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: TBD)

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

• 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++ 文档 for [[noreturn]]