errno

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

错误处理

错误码

错误码

errno

断言

assert

static_assert (C11)(C23 中移除)

边界检查

set_constraint_handler_s (C11)

abort_handler_s (C11)

ignore_handler_s (C11)

 

在标头 <errno.h> 定义
#define errno /*implementation-defined*/

errno 是一个预处理器宏（见后述），展开成线程局域的 (C11 起) int 类型可修改左值。一些标准库函数通过写入正整数到 errno 指定错误。通常，会将 errno 的值设置为错误码之一。错误码作为以字母 E 后随大写字母或数字开始的宏常量，列于 <errno.h> 。

errno 的值在程序启动时为 ​0​ ，而且无论是否出现错误，都允许库函数将正整数写入 errno ，不过库函数决不会将 ​0​ 存储于 errno 。

库函数 perror 和 strerror 能用于获得对应当前 errno 值的错误条件的文本描述。

注解： C11 前， C 标准有矛盾的要求，称 errno 是宏但亦称“不指明 errno 是宏还是声明带外部链接的标识符”。 C11 修正了此错误，要求必须定义它为宏（参阅 WG14 N1338 ）。

示例

运行此代码

#include <stdio.h>
#include <math.h>
#include <errno.h>
 
void show_errno(void)
{
    const char *err_info = "unknown error";
    switch (errno) {
    case EDOM:
        err_info = "domain error";
        break;
    case EILSEQ:
        err_info = "illegal sequence";
        break;
    case ERANGE:
        err_info = "pole or range error";
        break;
    case 0:
        err_info = "no error";
    }
    fputs(err_info, stdout);
    puts(" occurred");
}
 
int main(void)
{
    fputs("MATH_ERRNO is ", stdout);
    puts(math_errhandling & MATH_ERRNO ? "set" : "not set");
 
    errno = 0;
    1.0/0.0;
    show_errno();
 
    errno = 0;
    acos(+1.1);
    show_errno();
 
    errno = 0;
    log(0.0);
    show_errno();
 
    errno = 0;
    sin(0.0);
    show_errno();
}

可能的输出：

MATH_ERRNO is set
no error occurred
domain error occurred
pole or range error occurred
no error occurred

引用

• C11 标准（ISO/IEC 9899:2011）：

• 7.5 Errors <errno.h> （第 205 页）

• K.3.1.3 Use of errno （第 584 页）

• K.3.2 Errors <errno.h> （第 585 页）

• C99 标准（ISO/IEC 9899:1999）：

• 7.5 Errors <errno.h> （第 186 页）

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.1.3 Errors <errno.h>

参阅

E2BIG, EACCES, ..., EXDEV	标准 POSIX 兼容的错误条件宏 (宏常量)
perror	显示对应当前错误的字符串到 stderr (函数)
strerrorstrerror_sstrerrorlen_s (C11)(C11)	返回给定错误码的文本版本 (函数)
math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C99)(C99)(C99)	定义用于常用数学函数的错误处理机制 (宏常量)