C / C++ / 系统课时
区分 stdio 与低级 I/O
区分 stdio 与低级 I/O
这一课把 FILE * 与文件描述符放在同一张心智模型里:理解 stdio 的用户态缓冲,掌握 fopen、fread、fwrite、fflush、fileno、fdopen 的职责,并知道什么时候绝不能把 stdio 与 read/write 随意混用。
学习目标
- 区分
FILE *流、用户态缓冲区与内核文件描述符各自负责的事情。 - 正确使用
fileno与fdopen在两套接口之间建立联系,并处理所有权。 - 识别混用 stdio 与
read/write时的缓冲、偏移和顺序风险。
把 FILE 流和文件描述符分层理解
open 返回的是整数文件描述符,read/write 直接围绕这个描述符工作;fopen 返回的是 FILE *,stdio 会在用户态维护缓冲、错误标志、EOF 状态和格式化 I/O 所需的额外状态。最终需要访问文件时,stdio 仍要通过底层文件描述符进入内核。
fileno(fp) 只是取得某个 FILE * 当前关联的文件描述符,它不会刷新缓冲,也不会转移所有权。fdopen(fd, mode) 则用一个已有描述符创建 FILE *;成功后通常应让这个流负责后续关闭,调用 fclose(fp) 时会一并关闭底层描述符,不要再对同一个 fd 单独 close。

用一段程序串起 fopen、fdopen 与缓冲
下面的主示例先用 open 获得描述符,再用 fdopen 把它包装为 stdio 输出流。写入后通过 fflush 明确提交用户态输出缓冲,fclose 负责关闭底层描述符;随后再用 fopen 打开同一文件,并用 fread 读取内容。
#define _POSIX_C_SOURCE 200809L
#include <fcntl.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>
int main(void) {
int fd = open("stdio-demo.txt",
O_WRONLY | O_CREAT | O_TRUNC | O_CLOEXEC,
0644);
if (fd == -1) {
perror("open");
return 1;
}
FILE *out = fdopen(fd, "w");
if (out == NULL) {
perror("fdopen");
close(fd); /* fdopen 失败时,描述符仍由调用者负责 */
return 1;
}
const char *msg = "hello stdio\n";
size_t len = strlen(msg);
if (fwrite(msg, 1, len, out) != len) {
perror("fwrite");
fclose(out);
return 1;
}
printf("write stream fd: %d\n", fileno(out));
if (fflush(out) == EOF) {
perror("fflush");
fclose(out);
return 1;
}
if (fclose(out) == EOF) {
perror("fclose");
return 1;
}
FILE *in = fopen("stdio-demo.txt", "r");
if (in == NULL) {
perror("fopen");
return 1;
}
char buf[64];
size_t n = fread(buf, 1, sizeof buf - 1, in);
if (ferror(in)) {
perror("fread");
fclose(in);
return 1;
}
buf[n] = '\0';
printf("read stream fd: %d\n", fileno(in));
printf("content: %s", buf);
if (fclose(in) == EOF) {
perror("fclose");
return 1;
}
return 0;
}预期结果
程序成功时退出码为 0;stdio-demo.txt 中包含一行 hello stdio。fileno 返回的具体文件描述符编号取决于进程当前已占用的描述符。把源码保存为 stdio_fd.c,编译并运行:
cc -Wall -Wextra -O2 stdio_fd.c -o stdio_fd
./stdio_fd预期输出
write stream fd: <FD>
read stream fd: <FD>
content: hello stdio其中 <FD> 是运行时分配的文件描述符编号;两个位置的实际值都可能不同,也可能因为编号复用而相同。
理解 fread、fwrite 与 fflush 的语义
fread(ptr, size, nmemb, fp) 和 fwrite(ptr, size, nmemb, fp) 返回的是成功处理的元素个数,不是固定意义上的字节数。只有在 size == 1 时,返回值才可以直接按字节数理解。短读还可能由 EOF 引起,因此读取后要结合 feof(fp) 与 ferror(fp) 区分“正常结束”和“发生错误”。
对输出流,fflush(fp) 会把 stdio 尚未提交的输出数据推进到底层文件描述符;成功返回 0,失败返回 EOF。fclose(fp) 也会尝试刷新并关闭流,因此重要输出应检查其返回值,而不是假定 fwrite 成功就代表数据已经完成所有后续写出步骤。
不要让两套数据 I/O 同时抢同一个偏移
最危险的做法,是一边通过 FILE * 调用 fread/fwrite,一边又对 fileno(fp) 得到的描述符直接 read/write。输出流可能还留有用户态缓冲,于是原始 write 先到内核、stdio 数据后刷新,实际顺序就与源码顺序不同;输入流还可能预读数据,使内核文件偏移已经走到 FILE * 逻辑位置之后。
因此,数据读写通常应在同一个打开对象上只选择一套抽象:要么全程使用 stdio,要么全程使用低级 I/O。fileno 更适合配合 fstat、fcntl 等需要描述符但不直接消费文件数据的操作;如果确实必须切换数据 I/O,应先按 POSIX 规则同步流状态与文件位置,并把这种切换限制在很小的边界内。
对于 fdopen,还要记住“包装”不等于“复制”:它不会创建独立的文件偏移,也不会给你第二份独立生命周期。选择 FILE * 还是文件描述符,本质上是在选择缓冲和状态管理方式;真正稳妥的代码会明确唯一的数据 I/O 入口,而不是在两套接口之间来回穿插。