内存文件流：fmemopen 与 open_memstream

说实话，我刚开始学 C 语言那会儿，对文件操作的理解就是「读写磁盘上的文件」。后来有个项目需要在内存里临时拼装一段数据，再传给另一个模块解析——如果每次都写磁盘再读回来，效率低不说，还容易留下临时文件。嗯，这时候就该内存文件流登场了。

说白了，内存文件流就是让你把一块内存当成文件来操作。你可以用 fprintf、fscanf、fread、fwrite 这些标准函数，但数据根本不落盘，全在内存里倒腾。我个人习惯在需要动态构建字符串、或者做协议数据包组装时，优先考虑这个方案。

fmemopen：打开一块已有的内存

fmemopen 的作用，是把一块你已经分配好的内存区域，包装成一个 FILE * 流。它的原型长这样：

#include <stdio.h>

FILE *fmemopen(void *buf, size_t size, const char *mode);

参数说明：

  • buf：指向你准备好的内存缓冲区
  • size：缓冲区的大小
  • mode：打开模式，和 fopen 类似，比如 "r"、"w"、"r+" 等

返回一个 FILE * 指针，操作完后记得 fclose。

核心要点：fmemopen 不会帮你分配内存，你得自己提前准备好缓冲区。它只是「借用」你的内存来模拟文件操作。

来看一个实际例子。我在项目中曾经需要把几个结构体字段格式化成一个字符串，然后传给日志模块。用 sprintf 当然也行，但长度不好控制，容易溢出。用 fmemopen 就优雅多了：

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

int main() {
    char buffer[256];
    FILE *stream = fmemopen(buffer, sizeof(buffer), "w");
    if (!stream) {
        perror("fmemopen");
        return 1;
    }

    fprintf(stream, "设备ID: %d\n", 1001);
    fprintf(stream, "温度: %.2f°C\n", 36.5);
    fprintf(stream, "状态: %s\n", "正常");

    fclose(stream);

    // 此时 buffer 里就是组装好的内容
    printf("组装结果:\n%s", buffer);
    return 0;
}

运行结果：

组装结果:
设备ID: 1001
温度: 36.50°C
状态: 正常

注意，fclose 之后，buffer 里就已经写入了数据。你不需要再额外做任何拷贝操作。

我曾经踩过的坑：fmemopen 的 mode 参数如果用了 "w"，它不会清空你整个缓冲区，而是从起始位置开始写。如果你之前 buffer 里有旧数据，超出新写入长度的部分仍然存在。所以要么自己 memset 清零，要么用 "w+" 模式并注意读取位置。

open_memstream：动态增长的流

open_memstream 和 fmemopen 最大的区别在于：它会自动帮你管理内存。你不需要预先分配缓冲区，它会动态分配，并且随着你写入的数据自动增长。

#include <stdio.h>

FILE *open_memstream(char **buf, size_t *size);

参数说明：

  • buf：指向一个 char * 指针的地址。函数内部会分配内存，并把地址写到这里
  • size：指向一个 size_t 变量的地址。函数会更新这个变量为当前缓冲区的大小

你想想看，这比 fmemopen 灵活多了。你不需要提前估算数据量，写多少它就扩多少。我个人觉得，在不确定最终数据长度的场景下，open_memstream 是更好的选择。

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

int main() {
    char *buf = NULL;
    size_t size = 0;
    FILE *stream = open_memstream(&buf, &size);
    if (!stream) {
        perror("open_memstream");
        return 1;
    }

    for (int i = 0; i < 10; i++) {
        fprintf(stream, "第 %d 行数据\n", i + 1);
    }

    fclose(stream);

    // 此时 buf 指向动态分配的内存，size 是实际数据长度
    printf("共写入 %zu 字节:\n%s", size, buf);

    free(buf);  // 别忘了释放！
    return 0;
}

运行结果：

共写入 120 字节:
第 1 行数据
第 2 行数据
...
第 10 行数据

使用技巧：open_memstream 写入的数据末尾会自动追加 '\0'，所以你可以直接把 buf 当成字符串使用。但注意，size 变量记录的是实际数据长度，不包括结尾的 '\0'。

两者的对比

特性 fmemopen open_memstream
内存管理 由调用者提供缓冲区 自动动态分配
缓冲区大小 固定，不可增长 自动增长
适用场景 已知最大数据量，复用缓冲区 数据量不确定，或需要动态构建
释放方式 调用者自己管理 需要 free(buf)
读取支持 支持，可读写 只写（写入后可通过 buf 读取）

这里有个细节：open_memstream 打开的是「只写」流。你虽然可以通过 buf 指针直接读取内容，但不能用 fread、fscanf 等读取函数。而 fmemopen 支持读写模式，比如 "r+" 就可以同时读写。

知识结构图

下面这张图帮你理清这两个函数的关系和适用场景：

内存文件流核心知识结构 内存文件流 fmemopen open_memstream 固定缓冲区 支持读写 调用者管理内存 自动增长 只写模式 需 free 释放 共同点：用标准文件IO函数操作内存 fclose 后数据仍在，不落磁盘

避坑指南

我这些年用这两个函数，遇到过几个比较隐蔽的问题，分享给你：

  • fmemopen 的 mode 和缓冲区位置：用 "w" 模式时，写入位置从缓冲区开头算起。但如果你之前用 "r+" 读过，位置指针可能已经移动了。记得用 fseek 或 rewind 重置。
  • open_memstream 的 buf 指针：在 fclose 之前，buf 指向的内容是不稳定的。不要提前去读它，也不要在 fclose 之前 free 它——那是函数内部管理的。
  • 跨平台问题：这两个函数是 POSIX 标准的一部分，Windows 上的 MSVC 并不支持。如果你写跨平台代码，需要用条件编译或者自己封装一层。

我的建议：如果你只是临时组装字符串，open_memstream 更省心。如果你需要反复读写同一块内存，或者对性能有极致要求（避免动态分配），fmemopen 更合适。没有银弹，看场景选。

好了，内存文件流就聊到这儿。这两个函数用好了，能让你在很多场景下写出更干净、更高效的代码。下次遇到需要临时拼数据的情况，不妨试试它们。

← 上一章 📖 返回目录 下一章 →