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。

stdio 与文件描述符的分层关系

用一段程序串起 fopen、fdopen 与缓冲

下面的主示例先用 open 获得描述符,再用 fdopen 把它包装为 stdio 输出流。写入后通过 fflush 明确提交用户态输出缓冲,fclose 负责关闭底层描述符;随后再用 fopen 打开同一文件,并用 fread 读取内容。

c
#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;
}

预期结果

text
程序成功时退出码为 0;stdio-demo.txt 中包含一行 hello stdio。fileno 返回的具体文件描述符编号取决于进程当前已占用的描述符。

把源码保存为 stdio_fd.c,编译并运行:

bash
cc -Wall -Wextra -O2 stdio_fd.c -o stdio_fd
./stdio_fd

预期输出

text
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 入口,而不是在两套接口之间来回穿插。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分 stdio 与低级 I/O

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通