「C系列」C 错误处理

一、C 错误处理

在C语言中，错误处理是一个重要的编程实践，用于确保程序在遇到错误或异常情况时能够做出适当的响应。C语言没有内建的异常处理机制（如Java或C++中的try-catch块），但你可以使用多种方法来处理错误。

以下是一些在C语言中处理错误的常见方法：

1. 返回值：
   函数可以使用其返回值来表示是否成功执行。通常，如果函数成功执行，则返回0（或某种特定的非负值），如果出错，则返回非零值（或特定的负值）。

int divide(int a, int b, int *result) {  
    if (b == 0) {  
        // 错误：除数为0  
        return -1; // 返回非零值表示错误  
    }  
    *result = a / b;  
    return 0; // 返回0表示成功  
}

2. 设置全局错误标志：
   你可以定义一个全局变量来指示是否发生了错误，并在需要时检查它。

int global_error_flag = 0; // 初始化为0，表示没有错误  
 
void some_function() {  
    // ... 函数代码 ...  
    if (/* 错误条件 */) {  
        global_error_flag = 1; // 设置错误标志  
    }  
    // ...  
}  
 
// 在其他地方检查错误标志  
if (global_error_flag) {  
    // 处理错误  
}

3. 使用errno：
   errno 是一个在 <errno.h> 中定义的全局变量，用于报告系统调用的错误。你可以检查 errno 的值来确定是否发生了错误，并使用 perror 或 strerror 函数来获取关于错误的描述。

#include <stdio.h>  
#include <stdlib.h>  
#include <errno.h>  
#include <string.h>  
 
int main() {  
    FILE *fp = fopen("nonexistentfile.txt", "r");  
    if (fp == NULL) {  
        fprintf(stderr, "Error opening file: %s\n", strerror(errno));  
        return 1;  
    }  
    // ... 文件操作 ...  
    fclose(fp);  
    return 0;  
}

4. 使用指针参数：
   如前面 divide 函数的示例所示，你可以使用指针参数来返回额外的信息，如结果或错误代码。
5. 日志记录：
   对于复杂的程序，将错误信息记录到日志文件中可能很有用。这可以帮助你稍后分析和调试问题。
6. 断言（Assertions）：
   在开发和测试阶段，你可以使用断言（assert 宏，定义在 <assert.h> 中）来检查程序中的错误条件。如果断言失败（即条件为假），程序将打印一条消息并终止。断言主要用于调试目的，不应在生产代码中使用。
7. 自定义错误处理函数：
   你可以编写自定义的错误处理函数，这些函数可以根据需要执行特定的操作，如记录错误、显示消息或尝试恢复。
8. 清理和退出：
   当发生错误时，确保清理所有已分配的资源（如内存或文件描述符），然后安全地退出程序。这有助于防止资源泄漏和其他潜在问题。

二、errno、perror() 和 strerror()

以下是使用 errno、perror() 和 strerror() 在 C 语言中处理错误的代码案例：

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

// 示例函数，尝试打开一个文件
FILE *open_file(const char *filename, const char *mode) {
    FILE *fp = fopen(filename, mode);
    if (fp == NULL) {
        // fopen 失败时，errno 被设置为对应的错误码
        // 这里可以使用 perror() 或 strerror() 来获取错误信息
        // 使用 perror() 直接打印错误信息到 stderr
        perror("Error opening file");
        // 或者使用 strerror() 将错误码转换为字符串，并自定义打印方式
        fprintf(stderr, "Error opening file: %s\n", strerror(errno));
        return NULL;
    }
    return fp;
}

int main() {
    FILE *fp;

    // 尝试打开一个不存在的文件
    fp = open_file("nonexistentfile.txt", "r");
    if (fp == NULL) {
        // 文件打开失败，open_file 函数已经处理了错误输出
        // 这里可以继续其他的错误处理逻辑，或者退出程序
        return EXIT_FAILURE;
    }

    // 如果文件打开成功，这里可以进行文件读写操作...

    // 关闭文件
    fclose(fp);

    // 如果程序执行到这里，表示一切正常
    return EXIT_SUCCESS;
}

在这个例子中，open_file 函数尝试打开一个文件。如果 fopen 调用失败（例如，因为文件不存在或没有权限），它会设置全局变量 errno 来指示发生了什么错误。然后，open_file 函数使用 perror 直接打印出一个包含 errno 对应的错误描述的消息到标准错误流 stderr。另外，它也展示了如何使用 strerror 函数将 errno 转换为一个可读的错误字符串，并将其与自定义的错误消息一起打印。

在 main 函数中，如果 open_file 返回 NULL（表示文件打开失败），则程序会输出错误信息并返回退出状态 EXIT_FAILURE。如果文件成功打开，程序可以继续进行其他的文件读写操作，并在完成后关闭文件。如果程序能够正常执行到结束，它将返回退出状态 EXIT_SUCCESS。

三、C 被零除的错误

在C语言中，当尝试进行除法运算并且除数为零时，会触发一个运行时错误，通常被称为“被零除”或“除以零”错误。这种错误在大多数现代操作系统上会导致程序崩溃，并可能生成一个类似于“浮点异常”或“除以零”的错误消息。

对于整数除法，当除数为零时，大多数编译器会发出警告或错误，因为这种行为在C语言标准中是未定义的（Undefined Behavior）。然而，即使编译器没有发出警告，运行时环境也会捕获这个错误并导致程序异常终止。

以下是一个触发被零除错误的简单示例：

#include <stdio.h>

int main() {
    int a = 10;
    int b = 0;
    int result;

    // 尝试进行除以零的操作
    result = a / b; // 这将触发运行时错误

    printf("Result: %d\n", result); // 这行代码不会被执行

    return 0; // 程序不会正常返回
}

在这个例子中，当尝试执行 a / b 时，由于 b 是零，程序将触发一个运行时错误，并且通常不会执行 printf 语句或返回0。

为了避免被零除错误，你可以在除法操作之前检查除数是否为零：

#include <stdio.h>

int main() {
    int a = 10;
    int b = 0;
    int result;

    // 检查除数是否为零
    if (b == 0) {
        printf("Error: Division by zero is not allowed.\n");
        return 1; // 返回非零值表示错误
    }

    // 如果除数不为零，则执行除法操作
    result = a / b;
    printf("Result: %d\n", result);

    return 0; // 程序正常返回
}

在这个修改后的示例中，程序首先检查除数 b 是否为零。如果是，则打印一个错误消息并返回1。如果除数不为零，则程序会安全地执行除法操作并打印结果。

四、C 程序退出状态

在C语言中，程序可以通过返回给操作系统的状态码来指示其执行的成功或失败。这个状态码被称为程序的“退出状态”或“返回码”。在main函数中，你可以通过返回int类型的值来设置程序的退出状态。

通常，如果程序成功执行，main函数应返回EXIT_SUCCESS（在<stdlib.h>中定义为0）。如果程序因为某种错误而提前终止，main函数应返回EXIT_FAILURE（在<stdlib.h>中通常定义为一个非零值，但具体值可能因系统而异）。你也可以返回其他非零值来表示不同类型的错误。

下面是一个简单的示例，演示了如何根据条件设置C程序的退出状态：

#include <stdio.h>
#include <stdlib.h>

int main() {
    int result;
    int divisor = 0;

    // 尝试进行除法运算，但这里除数为零，将会导致错误
    int dividend = 10;
    if (divisor != 0) {
        result = dividend / divisor;
        printf("Result: %d\n", result);
        return EXIT_SUCCESS; // 如果除法成功执行，返回成功状态
    } else {
        fprintf(stderr, "Error: Division by zero is not allowed.\n");
        return EXIT_FAILURE; // 如果除数为零，返回失败状态
    }
}

在这个例子中，如果除数为零，程序会打印一条错误消息到标准错误流（stderr），并通过返回EXIT_FAILURE来指示程序未能成功执行。否则，如果除法成功执行，程序会打印结果并通过返回EXIT_SUCCESS来指示成功。

在Unix和类Unix系统中（如Linux和macOS），你可以使用shell命令echo $?来查看最近一个命令（包括C程序）的退出状态。在Windows系统中，你可以使用命令提示符或PowerShell中的类似机制来查看退出状态。

注意：虽然EXIT_SUCCESS和EXIT_FAILURE在<stdlib.h>中有定义，但它们的实际值可能因编译器和系统而异。不过，通常你可以假设EXIT_SUCCESS为0，而EXIT_FAILURE为非零值。在你的代码中，直接使用这些宏而不是硬编码具体的值是一个好习惯，因为它提高了代码的可移植性。

五、相关链接

1. Visual Studio Code下载地址
2. Sublime Text下载地址
3. 「C系列」C 简介
4. 「C系列」C 基本语法
5. 「C系列」C 数据类型
6. 「C系列」C 变量及常见问题梳理
7. 「C系列」C 常量
8. 「C系列」C 存储类
9. 「C系列」C 运算符
10. 「C系列」C 判断/循环
11. 「C系列」C 函数
12. 「C系列」C 作用域规则
13. 「C系列」C 数组
14. 「C系列」C enum(枚举)
15. 「C系列」C 指针及其应用案例