strerror (Strings) – C 中文开发手册

[
  •   C 语言中文开发手册

    strerror (Strings) - C 中文开发手册

    在头文件<string.h>中定义 ​ ​
    char * strerror（int errnum）; (1) ​
    errno_t strerror_s（char * buf，rsize_t bufsz，errno_t errnum）; (2) （自C11以来）
    size_t strerrorlen_s（errno_t errnum）; (3) （自C11以来）

    1）返回一个指向系统错误代码errnum的文本描述的指针，与由perror（）打印的描述相同。errnum通常是从errno变量中获取的，但是该函数接受int类型的任何值。 字符串的内容是特定于语言环境的。返回的字符串不能被程序修改，但可能会被随后对strerror函数的调用覆盖。 strerror不需要是线程安全的。 实现可能会返回指向静态只读字符串文字的不同指针，或者可能一遍又一遍地返回相同的指针，指向strerror放置字符串的静态缓冲区。2）与（1）相同，但消息复制到用户提供的存储器buf中。 不超过bufsz-1字节被写入，缓冲区总是空终止的。 如果消息必须被截断以适应缓冲区，并且bufsz大于3，则只写入bufsz-4字节，并且在空终止符之前附加字符“...”。 另外，在运行时检测到以下错误并调用当前安装的约束处理函数：buf 是一个空指针 bufsz 是零或大于 RSIZE_MAX 如果写入buf发生在数组的末尾（这可能发生在buf指向的缓冲区的大小小于错误消息中小于bufsz的字符数时可能发生），则行为未定义。3）计算如果使用errnum调用时，strerror_s会编写的未截断的特定于语言环境的错误消息的长度。 该长度不包括空终止符。 与所有边界检查函数一样，只有在__STDC_LIB_EXT1__由实现定义且用户在包含string.h之前将__STDC_WANT_LIB_EXT1__定义为整数常量1时，strerror_s和strerrorlen_s才能保证可用。

    参数

    差错编号 - 整数值是指错误代码
    BUF - 指向用户提供的缓冲区的指针
    bufsz - 用户提供的缓冲区大小

    返回值

    1）指向与errno错误代码errnum相对应的空终止字节字符串。2）如果整个消息被成功存储buf，则为零，否则为非零。3）strerror_s将返回的消息的长度（不包括空终止符）

    注意

    POSIX允许对strerror的后续调用使先前调用返回的指针值无效。 它还指定它是控制这些消息内容的LC_MESSAGES语言环境构面。strerror_s是唯一的允许截断的边界检查函数，因为提供尽可能多的关于失败的信息被认为是更可取的。 为了类似的目的，POSIX还定义了strerror_r。

    例

    #define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <errno.h>
#include <string.h>
#include <locale.h>
 
int main(void)
{
    FILE *fp = fopen(tmpnam((char[L_tmpnam]){0}), "r");
    if(fp==NULL) {
        printf("File opening error: %s\n", strerror(errno));
        setlocale(LC_MESSAGES, "de_DE.utf8");
        printf("Now in German: %s\n", strerror(errno));
#ifdef __STDC_LIB_EXT1__
        setlocale(LC_ALL, "zh_CN.utf8"); // printf needs CTYPE for multibyte output
        size_t errmsglen = strerrorlen_s(errno) + 1;
        char errmsg[errmsglen]; 
        strerror_s(errmsg, errmsglen, errno);
        printf("Now in Chinese: %s\n", errmsg);
#endif
    }
}

    可能的输出：

    File opening error: No such file or directory
Now in German: Datei oder Verzeichnis nicht gefunden
Now in Chinese: 没有那个文件或目录

    参考

    C11标准（ISO / IEC 9899：2011）： 7.24.6.2 strerror函数（p：371） K.3.7.4.2 strerror_s函数（p：622） K.3.7.4.3 strerrorlen_s函数（p：623） C99标准（ISO / IEC 9899：1999）： 7.21.6.2 strerror函数（p：334） C89 / C90标准（ISO / IEC 9899：1990）： 4.11.6.2 strerror函数

    扩展内容

    PERROR 显示当前错误对应的字符串到stderr（函数）
    errno 宏扩展到POSIX兼容的线程局部错误号变量（宏变量）

    | 用于strerror的C ++文档 |

  •   C 语言中文开发手册
    ]
    转载请保留页面地址：https://www.breakyizhan.com/c-3/28025.html

    posted on 2020-07-07 21:17  MrAit  阅读(371)  评论(0)  编辑  收藏  举报

    导航