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

 

C

编译器支持

语言

头文件

类型支持

程序工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

C 语言

基本概念

关键字

预处理器

语句

表达式

初始化

声明

函数

杂项

C 语言的历史

技术规范

 

函数

函数声明

函数定义

可变参数

inline (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 函数说明符 (页码: 待定)

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

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

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

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

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

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

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

参见

[[noreturn]](C23)[[_Noreturn]](C23)(已弃用) {{{notes}}}	指示函数不会返回 (属性说明符)[编辑]
[[noreturn]] 的 C++ 文档