[a] setvbuf / setbuf
#include <stdio.h> int setvbuf(FILE *restrict fp, char *restrict buf, int mode, size_t size) //成功返回 0，出错返回非 0 void setbuf(FILE *restrict fp, char *restrict buf)
- mode：_IONBF / _IOLBF / _IOFBF，即无缓冲、行缓冲、全缓冲
- setvbuf：若 mode 为 _IONBF，忽略 buf 与 size 的值；若 buf 为 NULL 且为缓冲模式，可不指定 size，系统将自动分配
- setbuf 通过将 buf 设置为 NULL 或 BUFSIZ 关闭或开启缓冲，缓冲的模式由系统根据连接的对象自动选择
[b] fflush
#include <stdio.h> int fflush(FILE *fp) //成功返回 0，出錯返回 EOF
- 手动冲洗待输出的标准 I/O 缓冲，对输入方向的缓冲无效
[c] fopen / fdopen / freopen
#include <stdio.h> FILE *fopen(const char *restrict path, const char *restrict type) FILE *fdopen(int fd, const char *type) FILE *freopen(const char *path, const char *type, FILE *fp) //成功返回文件指针，出错返回 NULL
- type：r / w / a / r+ / w+ / a+，对应的 open 标志分别为 O_RDONLY / O_WRONLY|O_CREAT|O_TRUNC / O_WRONLY|O_CREAT|O_APPEND / O_RDWR / O_RDWR|O_CREAT|O_TRUNC / O_RDWR|O_CREAT|O_APPEND
- fdopen 基于已打开的文件描述符生成流指针
- freopen 用于重定向，以新打开的流指针取代目标 fp（如 stdout / stdin 等）
[d] fclose
#include <stdio.h> int fclose(FILE *fp) //成功返回 0，出错返回 EOF
- 冲洗待输出数据，丢弃所有输入数据，关闭流指针
[e] fgetc / getc / getchar
#include <stdio.h> int fgetc(FILE *fp) int getc(FILE *fp) int getchar(void) //成功返回下一个字符，到达文件末尾或出错返回 EOF
- 用于读取单个字符，getc 实现为宏，getchar 相当于 getc(stdin)，fgetc 实现为函数
- 返回 EOF 时，需要使用 feof 与 ferror 区分到达文件末尾与出错两种状态
[f] ferror / feof / clearerr
#include <stdio.h> int ferror(FILE *fp) int feof(FILE *fp) //若条件为真，返回非 0，否则返回 0 void clearerr(FILE *fp)
- clearerr 用于清除 EOF 及错误标志
[g] ungetc
#include <stdio.h> int ungetc(int c, FILE *fp) //成功返回字符 c，出错返回 EOF
- 将指定字符压送回流中
[h] fputc / putc / putchar
#include <stdio.h> int fputc(char c, FILE *fp) int putc(char c, FILE *fp) int putchar(char c) //成功返回字符 c，出错返回 EOF
- putchar 等同于 putc(stdout)，fputc 则实现为函数
[i] fgets / fputs
#include <stdio.h> char *fgets(char *restrict buf, int n, FILE *restrict fp) //成功返回 buf，到达文件尾或出错返回 NULL int fputs(const char *restrict str, FILE *restrict fp) //成功返回非负值，出错返回 EOF
- fgets 从流中每次读取一行至 buf 中，至多读取 n - 1 个字符，以 字符结束，遇到 则停止读取， 会被读入
- fputs 将一个字符串写入到流中，不会自动添加 ， 字符不会写出
[j] ftell / fseek / rewind
#include <stdio.h> long ftell(FILE *fp) //成功返回当前位置，出错返回 -1 int fseek(FILE *fp, long offset, int whence) //成功返回 0，出错返回 -1 void rewind(FILE *fp)
- whence 的值可以为 SEEK_CUR / SEEK_SET / SEEK_END
- rewind 用于将流指针位置重置到文件开头
[k] fprintf / snprintf
#include <stdio.h> int fprintf(FILE *restrict fp, const char *restrict format, ...) //返回成功输出的不包括结尾 的字符数量 int snprintf(char *restrict buf, size_t n, const char *restrict format, ...) //同上
- snprintf 用于将至多 n - 1 个字符写入到 buf 中
- format 格式：'-' 减号表示左对齐(默认右对齐)，'+' 加号表示显示正负号，‘LF’ 指 long double，‘lld’ 指 long long int，‘z’ 指 size_t 类型，'j' 指 intmax_t 或 uintmax_t
[l] fscanf / sscanf
#include <stdio.h> int fscanf(FILE *restrict fp, const char *restrict format, ...) int sscanf(const char *restrict buf, const char *restrict format, ...) //成功返回输入的项数，出错或到达文件末尾返回 EOF
[m] fileno
#include <stdio.h> int fileno(FILE *fp) //返回与该流相关联的文件描述符
[n] mkdtemp / mkstemp
#include <stdlib.h> char *mkdtemp(char *template) //成功返回指向临时目录的指针，出错返回 NULL int mkstemp(char *template) //成功返回临时文件的描述符，出错返回 -1
- template 必须是以 ‘XXXXXX’ 结尾的可读写字符串(数组)，函数执行之后，template 的值会更新为实际的目录名或文件名
- 临时目录的权限是 0700，临时文件的权限是 0600
- 临时文件创建完成后处于打开状态，且不会自动删除，需要手动 unlink