【C语言】处理文件错误：详解 fopen, strerror 和 perror

已于 2024-08-12 14:59:09 修改
阅读量864 收藏 13
点赞数 25
分类专栏： C语言 文章标签： c语言 开发语言
于 2024-07-31 18:34:06 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Huangcancan666/article/details/140827857
版权

🦄个人主页:小米里的大麦-CSDN博客

🎏所属专栏:https://blog.csdn.net/huangcancan666/category_12718530.html

🎁代码托管:黄灿灿 (huang-cancan-xbc) - Gitee.com

⚙️操作环境:Visual Studio 2022

目录

一、引言

二、fopen 函数

解释：

注意： 

1. 函数原型

2. 参数

3. 代码示例

三、strerror 函数

1. 函数原型

2. 参数

3. 代码示例

四、perror 函数

1. 函数原型

2. 参数

3. 代码示例

小结

五、总的来说（可直接跳转至此处开始）

1. 错误处理的基础

errno 变量

strerror 函数

注意事项

2. 这里数据太多，所以我整理了常见的错误码及其描述：

3. 代码示例

3.1 示例一 

3.2 示例二 

4. 日常使用示例

六、总结

综合使用的重要性

七、共勉

一、引言

在 C 语言编程中，处理错误是非常重要的，尤其是当涉及到文件操作时。本文将详细介绍三个常用的错误处理函数：strerror, perror, 和 fopen 的使用方法。这些函数可以帮助开发者更好地理解和处理程序中发生的错误。

错误处理是编程中不可或缺的一部分。当程序遇到问题时，如文件无法打开或内存分配失败，程序需要能够捕捉这些错误并给出适当的反馈。C 语言提供了多种机制来处理这类错误，其中包括 strerror 和 perror 函数，它们可以提供详细的错误信息。

此外，我们还将讨论 fopen 函数，这是 C 语言中用于打开文件的标准函数。当 fopen 函数无法成功打开文件时，我们需要能够正确地处理这种失败，并向用户或开发者提供清晰的错误信息。

二、fopen 函数

解释：

  • fopen 是一个用于打开文件的标准库函数。它可以读取、写入或同时读写文件。如果文件不存在，fopen 可以创建新文件；如果文件存在，fopen 可以打开并重用它。
  • 即：fopen 是一个用于打开文件的函数，它可以在不同的模式下打开文件。如果我们尝试打开一个不存在的文件，或者因为权限问题无法打开文件，fopen 会返回 NULL。因此，我们通常会检查 fopen 的返回值是否为 NULL 来判断文件是否成功打开。

注意： 

  • 文件在读写之前应该先打开文件，在使用结束之后应该关闭文件。
  • 在编写程序的时候，在打开文件的同时，都会返回一个FILE*的指针变量指向该文件，也相当于建立了指针和文件的关系。
  • ANSIC 规定使用fopen函数来打开文件，fclose来关闭文件。

还是先来看看fopen - C++ Reference上的介绍：

1. 函数原型

#include <stdio.h>
FILE *fopen(const char *filename, const char *mode);

2. 参数

  • filename: 要打开的文件的路径和名称。
  • mode: 指定了打开文件的方式，常见的模式有 "r"（只读）、"w"（清空并写入新的数据）、"a"（追加到文件末尾）和 "r+"（读写）等。
文件使用方式
含义
如果指定文件不存在
“ r ”（只读）
为了输入数据，打开一个已经存在的文本文件
出错
“ w ”（只写）
为了输出数据，打开一个文本文件
建立一个新的文件
“ a ”（追加）
向文本文件尾添加数据
建立一个新的文件
“ rb ”（只读）
为了输入数据，打开一个二进制文件
出错
“ wb ”（只写）
为了输出数据，打开一个二进制文件
建立一个新的文件
“ ab ”（追加）
向一个二进制文件尾添加数据
出错
“ r+ ” （读写）
为了读和写，打开一个文本文件
出错
“ w+ ” （读写）
为了读和写，建议一个新的文件
建立一个新的文件
“ a+ ” （读写）
打开一个文件，在文件尾进行读写
建立一个新的文件
“ rb+ ” （读写）
为了读和写打开一个二进制文件
出错
“ wb+ ” （读写）
为了读和写，新建一个新的二进制文件
建立一个新的文件
“ ab+ ” （读写）
打开一个二进制文件，在文件尾进行读和写
建立一个新的文件

3. 代码示例

#include <stdio.h>

int main() {
    FILE* fp = fopen("test.txt", "r");
    if (fp == NULL) {
        // 处理打开失败的情况
        return 1;
    }

    // 文件成功打开后的操作...

    fclose(fp);//关闭文件
    return 0;
}

三、strerror 函数

strerror 函数是用来获取错误描述字符串的。当 fopen 或者其他函数失败时，它们通常会设置全局变量 errno 来表示错误的原因。strerror 可以将 errno 的值转换成一个描述性的字符串，从而帮助我们了解具体的错误信息。

strerror - C++ Reference 的介绍：

1. 函数原型

#include <string.h>
const char *strerror(int errnum);

2. 参数

errnum: 错误码，通常直接使用 errno。

3. 代码示例

#include <stdio.h>
#include <string.h>
#include <errno.h>

int main() {
    FILE* fp = fopen("test.txt", "r");
    if (fp == NULL) {
        fprintf(stderr, "Failed to open file: %s\n", strerror(errno));
        return 1;
    }

    // 文件成功打开后的操作...

    fclose(fp);
    return 0;
}
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <errno.h>

int main() {
    FILE *file;
    int errorNumber;

    file = fopen("example.txt", "r");
    if (file == NULL) {
        // 获取错误编号
        errorNumber = errno;
        printf("无法打开文件: %s\n", strerror(errorNumber));
        exit(EXIT_FAILURE);
    }

    // 如果文件成功打开，我们可以继续做其他事情...
    fclose(file);
    return 0;
}
在这段代码中，我们尝试打开名为 "example.txt" 的文件。
如果文件打开失败，我们将获取当前的 errno 值，
然后使用 strerror 函数将该值转换成描述性的错误字符串，并将其打印到标准输出。

请注意，上述代码使用了标准 C 库中的头文件和函数，确保在编译时链接相应的库。
此外，strerror 函数返回的字符串可能因操作系统而异。

四、perror 函数

perror 函数与 strerror 类似，但它会自动将错误描述打印到标准错误流（stderr）。此外，perror 还会在错误描述前加上一个自定义的消息，通常用来指定出错的函数名称。也就是主要用于打印错误信息，通常是在系统调用失败后使用，比如文件操作、内存分配等失败时。它会在标准错误输出（通常是终端）上打印一个描述性的错误消息。

perror - C++ Reference的介绍：

1. 函数原型

#include <stdio.h>
void perror(const char *msg);

2. 参数

msg: 这是一个字符串，通常表示出错的函数名称或其他相关信息，你可以传递任何描述性文字给它，比如 "无法创建文件"。

perror 函数的参数

perror 函数接受一个字符串参数。这个字符串是用来描述发生了什么错误的。例如：

  • "无法打开文件"
  • "内存分配失败"

参数可以是：

  • 任何字符串：可以是一个固定的字符串，比如 "无法打开文件"。
  • 动态生成的字符串：可以是根据程序运行时的状态动态生成的字符串，比如结合变量使用，如 "无法打开文件 %s"。

3. 代码示例

#include <stdio.h>
#include <errno.h>

int main() {
    FILE* fp = fopen("test.txt", "r");
    if (fp == NULL) {
        perror("fopen");
        return 1;
    }

    // 文件成功打开后的操作...

    fclose(fp);
    return 0;
}
直接使用字符串：
perror("无法打开文件");
使字符串变量：
char *errorMessage = "内存分配失败";
perror(errorMessage);
动态生成字符串：
char *filename = "example.txt";
fprintf(stderr, "无法打开文件 %s: ", filename);
perror("");
包含文件名的错误消息
在这个示例中，我们将使用 fprintf 向 stderr 输出文件名，然后调用 perror 打印出实际的错误描述。
#include <stdio.h>
#include <stdlib.h>

void openFileWithMessage(const char *filename) {
    FILE *fp = fopen(filename, "r");
    if (fp == NULL) {
        fprintf(stderr, "无法打开文件 %s: ", filename);
        perror("");  // 打印错误描述
        exit(EXIT_FAILURE);  // 终止程序执行
    }
    fclose(fp);
}

int main() {
    openFileWithMessage("不存在的文件.txt");
    return 0;
}
包含错误代码的错误消息
在这个示例中，我们将构造一个包含错误代码的错误消息。
#include <stdio.h>
#include <stdlib.h>
#include <string.h>  // 用于使用 strerror

void openFileWithErrorNumber(const char *filename) {
    FILE *fp = fopen(filename, "r");
    if (fp == NULL) {
        fprintf(stderr, "错误 %d: 无法打开文件 %s: ", errno, filename);
        perror("");  // 打印错误描述
        exit(EXIT_FAILURE);  // 终止程序执行
    }
    fclose(fp);
}

int main() {
    openFileWithErrorNumber("不存在的文件.txt");
    return 0;
}

小结

  • perror 函数括号里需要填写的是一个描述性的字符串，用来说明发生了什么错误。
  • 字符串可以是任何你想要的描述性文本。
  • 字符串可以是固定的字符串，也可以是动态生成的字符串。

五、总的来说（可直接跳转至此处开始）

1. 错误处理的基础

  • 在编程时，我们经常会遇到一些错误或异常情况。例如，打开文件失败、内存分配不足等。当这些错误发生时，程序通常会返回一个错误码，以便开发者能够识别出发生了什么问题。
  • 在 C 语言中，错误码通常是通过全局变量 errno 来传递的。errno 是一个整数变量，它会在系统调用或者库函数失败时被设置为特定的值来表示不同的错误类型。

errno 变量

  • errno 是一个预定义的全局变量，在 <errno.h> 头文件中定义。每次系统调用或库函数失败后，它会被设置成一个表示错误原因的整数值。每个错误码都有一个对应的描述字符串，可以帮助理解错误的具体含义。

strerror 函数

  • strerror 函数的作用是将 errno 的值转换成相应的错误描述字符串。这样你就可以通过打印这个字符串来告诉用户发生了什么错误。

注意事项

  • strerror 返回的字符串可能被其他调用覆盖，因此如果需要保留错误消息，应该复制到另一个字符串中。
  • 不同的操作系统可能有不同的错误码和错误消息。

2. 这里数据太多，所以我整理了常见的错误码及其描述：

 strerror 函数返回与给定错误码 (errno) 相对应的错误描述字符串。每个错误码都有一个特定的意义，并且与之对应有一个描述性的字符串。这些错误码及其描述字符串是由操作系统定义的，并且在不同平台上可能会有所不同。然而，大多数常见的错误码和它们的含义在各种 Unix 和类 Unix 系统（包括 Linux）中都是通用的。 

请注意，下面列出的错误码和描述并不是所有可能的错误码，而且具体的错误码数值和描述可能会根据不同的系统和平台有所不同。在实际使用中，你可以查阅你所使用的系统的文档来获取更准确的信息。 

3. 代码示例

3.1 示例一 

#include <stdio.h>
#include <string.h>
#include <errno.h>

int main() {
    int error_number = 2; // 假设这里发生了错误 2: No such file or directory
    const char *error_string = strerror(error_number);
    printf("Error description: %s\n", error_string);

    return 0;
}


运行上述代码会输出:
Error description: No such file or directory

3.2 示例二 

int main() {
    printf("%s\n", strerror(0));   // No error
    printf("%s\n", strerror(1));   // Operation not permitted
    printf("%s\n", strerror(2));   // No such file or directory
    printf("%s\n", strerror(3));   // No such process
    printf("%s\n", strerror(4));   // Interrupted function call
    printf("%s\n", strerror(5));   // Input/output error

    return 0;
}
  • strerror(0)：No error （没有错误）
  • strerror(1)：Operation not permitted （操作未被允许）
  • strerror(2)：No such file or directory （没有这样的文件或目录）
  • strerror(3)：No such process （没有这样的进程）
  • strerror(4)：Interrupted function call （中断的函数调用）
  • strerror(5)：Input/output error （输入/输出错误）

4. 日常使用示例

#include <stdio.h>    // 包含标准输入输出头文件
#include <stdlib.h>   // 包含标准库函数头文件，如 calloc 和 free

int main()
{
    int *p = (int*)calloc(10, sizeof(int));  // 分配足够的内存来存储10个整数，并初始化为0
    if (NULL == p)                           // 如果内存分配失败（p为NULL）
    {
        perror("calloc");                    // 打印错误信息
        return 1;                            // 返回非零值，表示程序异常终止
    }

    // 使用
    int i = 0;                               // 初始化循环变量
    for (i = 0; i < 10; i++)                 // 循环遍历数组中的每个元素
    {
        printf("%d ", *(p + i));             // 输出第i个元素的值
    }

    // 释放内存
    free(p);                                 // 释放之前分配的内存
    p = NULL;                                // 将指针设置为NULL以避免悬挂指针问题

    return 0;                                // 正常退出程序
}
这段代码的主要功能如下：

使用 calloc 函数分配足够空间来存放10个整数，并且将这些整数初始化为0。
检查内存是否成功分配，如果没有分配成功，则打印错误信息并退出程序。
使用一个循环来遍历这个整数数组，并打印每个整数的值。
使用 free 函数释放之前分配的内存。
将指针 p 设置为 NULL 以避免后续使用该指针时产生悬挂指针的问题。
最后返回0表示程序正常结束。

六、总结

综合使用的重要性

  • 错误处理的最佳实践：在文件操作中，结合使用 fopen, strerror, 和 perror 是一种很好的错误处理策略。
  • 提高程序健壮性：通过检查错误条件并提供清晰的错误信息，可以提高程序的稳定性和可靠性。
  • 易于维护：良好的错误处理机制使得代码更容易理解和维护，尤其是在大型项目中。

处理文件错误是一项基本但又复杂的任务。fopen, strerror, 和 perror 这些工具的正确使用能够显著提升程序的质量，使开发者能够更加高效地解决问题。通过掌握这些技巧，开发者可以构建更加健壮、可靠的应用程序。

七、共勉

小米里的大麦
关注
  • 25
    点赞
  • 踩
  • 13
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 1
    评论
专栏目录
Fopen函数创建打开文件失败，导致vfprintf函数失败，出现段错误
发呆的程序猿
09-05 1325
Fopen函数创建打开文件失败
在iphone上使用fopen打开文件失败，错误码24：EMFILE
最新发布
孙君的空间站
09-08 471
在iphone上使用fopen打开文件失败，错误码21：EMFILE。
fopen函数失败原因分析以及分析原因的方法
热门推荐
奋斗Andy的博客
12-21 6万+
概述： 最近在分析一个偶现的问题，偶现概率特别低，问题还在分析中。把分析的知识做个总结，后面再继续补充。 问题描述： 代码在调用Lua的require函数时发生异常，通过查看require的源码跟踪，发现该函数的fopen函数返回打开文件失败的异常， 下面就来总结下fopen打开文件出错可能有哪些原因，也许不全，欢迎补充。 函数介绍： 函数原型 FILE * fopen(con
fopen 使用错误总结
aircoder的博客
11-22 1009
char buf[MAX_LINE]; /* 缓冲区 */ FILE *fp; char * p; int i=0; char * pp ; char path[] = "/home/aircoder/c/logs/ff.log"; pp = path; /* while(path[i]!='\0') { pp[i] = path[i]...
Erron错误对照表
那个字念颀的博客
12-17 3906
} return 0; } 错误对照表： errno0 : Successerrno1 : Operation not permittederrno2 : No such file or directoryerrno3 : No such processerrno4 : Interrupted system callerrno5 : Inp
C语言错误处理函数的使用方法
I,Pencil
01-02 578
错误处理函数的使用方法 errno 是记录系统的最后一次错误代码。 代码是一个int型的值，在errno.h中定义。 当Linux C api函数发生异常时，一般会将errno全局变量赋一个整数值，不同的值表示不同的含义，可以通过查看该值推测出错的原因 #include <stdio.h> //fopen #include <errno.h> //errno #include <string.h> //strerror(errno) ​ int main() {
fopen函数_C语言编程第21讲——errno变量与strerror()函数
weixin_39617215的博客
11-28 277
在UNIX/Linux环境下进行C语言编程，当我们调用库函数失败时，我们可以通过全局变量errno获得错误编号，使用strerror(errno)函数，获得错误描述信息。下面我们举一个例子，打开一个不存在的文件：#include #include #include int main(){ FILE* fpTemp = fopen ("/mytemp/mytemp.txt", "r"); ...
fopen函数打开文件失败原因以及解决方法
weixin_41528941的博客
04-28 2万+
最近fopen遇到打不开文件的问题，参考下面的方法3问题解决了。 原文链接：https://blog.csdn.net/Andy_93/article/details/78865000 概述： 最近在分析一个偶现的问题，偶现概率特别低，问题还在分析中。把分析的知识做个总结，后面再继续补充。 问题描述： 代码在调用Lua的require函数时发生异常，通过查看require的源码跟踪，发现该函数的fopen函数返回打开文件失败的异常， 下面就来总结下fopen打开文件出错可能有哪些原因，也许不全，欢迎补充。
fopen打开文件失败的奇怪错误，errno = EMFILE
偏安的专栏
11-25 1万+
//2016.11.25 fopen打开文件失败的奇怪错误，日志调试GetlastError()返回0，但是errno = EMFILE。 实际错误并不在这里的fopen上，而在其他代码块里fopen很多文件一直没有fclose。errno返回了 C运行时库发生的最后一个错误。 GetlastError得到的是在Windows API函数最后一个错误（当前线程）。 例如： 1：调用WinA
fopen（）和open（）的区别、errno的使用
m0_65690223的博客
05-22 1400
使用`errno`的好处是可以标准化错误信息，并且可以提供更多的错误信息。在C语言中，很多函数在出错时会将错误码存储在全局变量`errno`中，这样就可以通过检查`errno`的值来判断函数是否执行成功，以及出错的具体原因。`errno`的使用方法如下：1. 在使用可能出错的函数时，需要先将`errno`的值清零，以便后续检查`errno`的值时不会受到之前的影响。2. 在检查`errno`的值之前，需要先判断函数是否执行成功。
C语言获取系统错误
tanglx(汤龙祥)的博客
07-23 388
文章目录一、strerror函数二、errno的细节1、调用库函数失败不一定会设置errno2、errno不能作为调用库函数失败的标志3、程序员可以不用errno三、课后作业四、版权声明 我们在写程序的时候需要调用C语言提供的库函数，并通过函数的返回值判断调用是否成功。其实在C语言中，还有一个全局变量errno，存放了函数调用过程中产生的错误码。 为防止和正常的返回值混淆，库函数的调用一般并不直接返回错误码，而是将错误码（是一个整数值，不同的值代表不同的含义）存入一个名为errno 的全局变量中，errno
嵌入式Linux标准IO，fopen（）,fclose(),错误信息处理errno,perror(),strerror()
m0_37542524的博客
11-04 3168
文章目录1，打开流fopen()fopen示例2，fopen()新建文件权限3，处理错误信息errno,perror(),strerror()处理错误信息 示例一perror()处理错误信息 示例二strerror(),errno4，关闭流fclose() 1，打开流fopen() 下列函数可用于打开一个标准I/O流： FILE *fopen (const char *path, const ...
fopen打开文件失败，一个小错误，一个教训！
xxxxyyyy123456789的博客
03-06 6648
fopen（path，mode）；fopen函数第一个参数为文件路径，若要打开的文件就在当前目录下，可直接写文件名，当我们把一个变量写在第一个参数的位置上时，可能出现找不到文件的错误。 原因：第一种是如果我们在socket编程里，客户端向服务器发送一个字符串变量（或服务器向客户端发送一个字符串变量），服务器（客户端）用一个字符数组去接受，如果只定义了字符数组，没有初始化这个数组，当把这个字符数组放在fopen第一个参数位置上时，会产生错误，错误码是2（找不到文件），因为我们没初始化这个数组，接受完客户端传来
错误 C4996 ‘fopen‘: This function or variable may be unsafe. Consider using fopen_s instead. To disabl
程序员，他们想的是什么?他们想的永远都是技术，他们崇尚的也永远都是技术。
04-22 2万+
编译出错信息 error C4996: ‘fopen’: This function or variable may be unsafe. Consider using fopen_s instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. See online help for details. 错误c4996 fopen的:这个函数或变量可能是不安全的，考虑改用fopen_s。 要禁用弃用，请使用_CRT_SECURE_NO_WARN
fopen函数报错
qiminglau的专栏
08-06 8759
vs2012中使用fopen出现的错误：error C4996: 'fopen': This function or variable may be unsafe. Consider using fopen_s instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. See online help for details. 我看
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

小米里的大麦

您的支持是我创作的最大动力！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值