文件与IO
C 提供两层 I/O 抽象:标准 I/O(<stdio.h>) 与 低级 I/O(POSIX <unistd.h>)。前者跨平台、带缓冲;后者贴近内核。理解二者差异是写高性能与正确 I/O 代码的基础。
一、标准 I/O 概览
<stdio.h> 提供 FILE * 抽象,屏蔽底层 fd/HANDLE 差异。
三个标准流
stdin— 标准输入(默认键盘)stdout— 标准输出(默认终端)stderr— 标准错误(默认终端,无缓冲)
二、打开 / 关闭
fopen
FILE *fp = fopen("data.txt", "r");
if (!fp) {
perror("fopen");
return -1;
}
模式字符串:
| 模式 | 含义 |
|---|---|
"r" | 只读,文件必须存在 |
"w" | 只写,清空或创建 |
"a" | 追加,创建或末尾写 |
"r+" | 读写,文件必须存在 |
"w+" | 读写,清空或创建 |
"a+" | 读写,追加 |
"b" | 二进制(Windows 关键,Unix 无差异) |
"x" (C11) | 独占创建,若已存在则失败 |
fclose
if (fclose(fp) == EOF) { /* 错误处理 */ }
- 刷新缓冲区、释放资源。
- 必须成功检查——
write失败可能推迟到fclose才暴露。
三、格式化输入输出
printf 家族
int printf(const char *fmt, ...); // to stdout
int fprintf(FILE *fp, const char *fmt, ...);
int sprintf(char *buf, const char *fmt, ...); // ✗ 不安全
int snprintf(char *buf, size_t n, const char *fmt, ...); // ✓ 推荐
int vprintf(const char *fmt, va_list args);
返回值:写入的字符数(不含 \0);错误返 <0。
snprintf 特点:
- 最多写
n-1个字符 +\0。 - 返回值是"如果 n 足够大会写入的字符数"——可能大于实际写入。这样可以先探测所需长度。
int need = snprintf(NULL, 0, "%d + %d = %d", a, b, a+b);
char *buf = malloc(need + 1);
snprintf(buf, need + 1, "%d + %d = %d", a, b, a+b);
scanf 家族
int scanf(const char *fmt, ...);
int fscanf(FILE *fp, const char *fmt, ...);
int sscanf(const char *buf, const char *fmt, ...);
返回值:成功匹配并赋值的项数;EOF 表读到文件末尾。
int n;
if (scanf("%d", &n) != 1) { /* 错误 */ }
陷阱:
scanf("%s", buf)不指定最大长度,缓冲区溢出。用scanf("%99s", buf)(buf 至少 100)。%d后紧跟%c会读到残留的换行符——通常先跳空白" %c"。- 出错后留下的 字符会残留在缓冲区,需要
getchar清空。
建议:新代码优先 fgets + sscanf,或 getline(POSIX):
char line[256];
if (fgets(line, sizeof line, stdin)) {
int n;
if (sscanf(line, "%d", &n) == 1) { ... }
}
常用格式说明符
| 说明符 | 类型 |
|---|---|
%d %i | int(十进制/自动进制) |
%u | unsigned int |
%x %X | 十六进制 |
%o | 八进制 |
%f %e %g | double |
%c | int(当字符) |
%s | char *(字符串,需 \0 结尾) |
%p | void *(指针) |
%zu | size_t |
%td | ptrdiff_t |
%lld | long long |
%ld | long |
%.3f | 精度 3 |
%10d | 宽度 10 |
%-10d | 左对齐 |
%08d | 填 0 |
%*d | 宽度从参数取 |
%% | 字面 % |
C99 长度修饰符:hh(char)、h(short)、l(long)、ll(long long)、j(intmax_t)、z(size_t)、t(ptrdiff_t)、L(long double)。
类型不匹配 = UB:
printf("%d", 3.14); // ✗ UB
printf("%s", NULL); // 实现定义(glibc 打印 "(null)")
编译器 -Wformat 或 GCC __attribute__((format(printf, ...))) 可以在编译期检查。
四、逐字符 / 逐行
字符
int c = fgetc(fp); // 一字节,EOF 或 (unsigned char)
int c = getchar(); // 从 stdin
int r = fputc(c, fp); // 写一字节
int r = putchar(c);
int u = ungetc(c, fp); // 回放一个字符(下一次读取会返回它)
注意:fgetc 返回 int,因为要能表达 EOF(通常 -1)。用 char 存返回值 → EOF 被截断,无法区分。
行
char *fgets(char *buf, int n, FILE *fp); // 最多 n-1 字符 + \0,含换行
int fputs(const char *s, FILE *fp); // 不加换行
int puts(const char *s); // 自动加换行 to stdout
POSIX getline:动态分配缓冲,处理任意长度行:
char *line = NULL;
size_t cap = 0;
ssize_t len;
while ((len = getline(&line, &cap, stdin)) != -1) {
process(line);
}
free(line);
五、二进制 I/O
fread / fwrite
size_t fread(void *buf, size_t size, size_t nmemb, FILE *fp);
size_t fwrite(const void *buf, size_t size, size_t nmemb, FILE *fp);
- 返回成功读/写的元素数(非字节数)。
- 出错或 EOF 时返回小于
nmemb。
int arr[100];
size_t n = fread(arr, sizeof(int), 100, fp); // 读 n 个 int
注意:直接把结构体写入文件时,内部对齐/padding/字节序都会影响兼容性——建议用显式协议(写每个字段的字节序化表示)。
六、定位
long ftell(FILE *fp); // 当前位置
int fseek(FILE *fp, long off, int whence); // whence: SEEK_SET, SEEK_CUR, SEEK_END
void rewind(FILE *fp); // 回到开头
C99 起有 fgetpos / fsetpos 处理大文件(fpos_t)。
七、缓冲
FILE * 默认带缓冲,避免每字节都系统调用:
- 全缓冲(fully buffered):文件流的默认。缓冲区满或
fflush才写出。 - 行缓冲(line buffered):
stdout连接到终端时。遇\n或缓冲区满才写。 - 无缓冲(unbuffered):
stderr。立即写。