编辑“︁C 语言返回码”︁

= C语言返回码 =

== 介绍 ==
在C语言中，'''返回码'''（Return Code）是一种常见的错误处理机制，用于表示函数执行的成功或失败状态。通常，函数通过返回一个整数值（即返回码）来通知调用者其执行结果。返回码的约定因函数而异，但通常遵循以下惯例：
* '''0''' 表示成功
* '''非零值''' 表示某种错误或异常情况

返回码是C语言中简单而有效的错误处理方式，尤其在系统编程和底层开发中广泛应用。

== 基本用法 ==
在C语言中，返回码通常通过函数的返回值传递。以下是一个简单的示例：

<syntaxhighlight lang="c">
#include <stdio.h>

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

int main() {
    int result;
    int ret = divide(10, 2, &result);
    if (ret == 0) {
        printf("结果: %d\n", result);
    } else {
        printf("错误: 除数不能为零\n");
    }
    return 0;
}
</syntaxhighlight>

'''输出:'''
<pre>
结果: 5
</pre>

'''解释:'''
* `divide` 函数尝试计算 `a / b`，并将结果存储在 `*result` 中。
* 如果 `b` 为 0，函数返回 `-1` 表示错误。
* 否则，返回 `0` 表示成功，并通过指针参数传递计算结果。

== 标准库中的返回码 ==
许多C标准库函数使用返回码来表示状态。例如：

* '''`fopen`'''：返回 `NULL` 表示失败
* '''`fclose`'''：返回 `EOF` 表示失败
* '''`atoi`'''：无法转换时行为未定义（通常不是好的设计）

示例：
<syntaxhighlight lang="c">
#include <stdio.h>

int main() {
    FILE *file = fopen("nonexistent.txt", "r");
    if (file == NULL) {
        perror("打开文件失败");
        return 1; // 返回非零表示错误
    }
    fclose(file);
    return 0;
}
</syntaxhighlight>

'''输出（如果文件不存在）:'''
<pre>
打开文件失败: No such file or directory
</pre>

== 返回码的优缺点 ==
=== 优点 ===
* 简单直接，易于实现
* 不依赖语言特性，可移植性好
* 在性能敏感的场景中开销小

=== 缺点 ===
* 容易被忽略（调用者可能不检查返回码）
* 错误信息有限（通常只是一个数字）
* 缺乏上下文（不知道错误发生的具体位置）

== 实际应用案例 ==
在Unix/Linux系统编程中，返回码广泛使用。例如：

=== 系统调用 ===
<syntaxhighlight lang="c">
#include <unistd.h>
#include <stdio.h>

int main() {
    if (access("/etc/passwd", R_OK) == 0) {
        printf("文件可读\n");
    } else {
        perror("access");
        return 1;
    }
    return 0;
}
</syntaxhighlight>

=== 进程退出状态 ===
Unix进程通过 `exit` 返回状态码，父进程可通过 `wait` 获取：
<syntaxhighlight lang="c">
#include <stdlib.h>
#include <stdio.h>

int main() {
    printf("正在退出...\n");
    exit(42); // 返回状态码 42
}
</syntaxhighlight>

在shell中检查：
<pre>
$ ./a.out
正在退出...
$ echo $?
42
</pre>

== 高级主题 ==
=== 错误码标准化 ===
大型项目通常会定义自己的错误码体系。例如：

<syntaxhighlight lang="c">
#define SUCCESS 0
#define E_INVALID_ARG 1
#define E_FILE_IO 2
#define E_MEMORY 3

int process_file(const char *filename) {
    if (filename == NULL) return E_INVALID_ARG;
    // ...
}
</syntaxhighlight>

=== 错误码与errno ===
C标准库的 `errno` 机制常与返回码配合使用：
<syntaxhighlight lang="c">
#include <errno.h>
#include <stdio.h>
#include <string.h>

int main() {
    FILE *f = fopen("nonexistent.txt", "r");
    if (f == NULL) {
        printf("错误 %d: %s\n", errno, strerror(errno));
        return errno;
    }
    fclose(f);
    return 0;
}
</syntaxhighlight>

== 最佳实践 ==
* 始终检查关键函数的返回码
* 为项目定义一致的错误码规范
* 考虑使用枚举提高可读性
* 对于重要错误，添加日志记录

== 总结 ==
C语言返回码是一种简单有效的错误处理机制，虽然有其局限性，但在系统编程和性能敏感的应用中仍然非常重要。理解并正确使用返回码是成为熟练C程序员的关键一步。

[[Category:编程语言]]
[[Category:C]]
[[Category:C 语言错误处理]]