C 风格的文件输入/输出

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数(C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步的输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

C 风格 I/O

类型与对象
FILE fpos_t	stdinstdoutstderr
函数
文件访问 fopen freopen fclose fflush fwide setbuf setvbuf 直接输入/输出 fread fwrite 无格式输入/输出 fgetcgetc fgets fputcputc fputs getchar gets (C++14 前) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 有格式输入 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	有格式输出 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf 文件定位 ftell fgetpos fseek fsetpos rewind 错误处理 clearerr feof ferror perror 文件上的操作 remove rename tmpfile tmpnam

 

C++ 标准库的 C 输入/输出子集实现了 C 风格流的输入/输出操作。<cstdio> 头文件提供了对通用文件操作的支持，并提供具有窄和多字节字符的输入/输出能力的函数，而 <cwchar> 头文件提供了具有宽字符输入/输出能力的函数。

C 流以 std::FILE 类型的对象所代表，只能通过 std::FILE* 类型的指针予以访问及操作。每个 C 流均与外部物理设备（文件、标准输入流、打印机、串口等）相关联。

类型

在标头 <cstdio> 定义
FILE	对象类型，足以保有控制 C 输入/输出流所需的全部信息 (typedef)
fpos_t	完整非数组对象类型，足以唯一指定文件中的位置，包含其多字节剖析状态 (typedef)

预定义标准流

在标头 <cstdio> 定义
stdinstdoutstderr	与输入流关联的 FILE* 类型表达式 与输出流关联的 FILE* 类型表达式 与错误输出流关联的 FILE* 类型表达式 (宏常量)

函数

在标头 <cstdio> 定义
文件访问
fopen	打开文件 (函数)
freopen	以不同名称打开既存流 (函数)
fclose	关闭文件 (函数)
fflush	将输出流与实际文件同步 (函数)
fwide	在宽字符输入/输出和窄字符输入/输出间切换文件流 (函数)
setbuf	为文件流设置缓冲区 (函数)
setvbuf	为文件流设置缓冲区与其大小 (函数)
直接输入/输出
fread	从文件读取 (函数)
fwrite	写入文件 (函数)
无格式输入/输出
字节/多字节字符
fgetcgetc	从文件流获取字符 (函数)
fgets	从文件流获取字符串 (函数)
fputcputc	写字符到文件流 (函数)
fputs	写字符串到文件流 (函数)
getchar	从 stdin 读取字符 (函数)
gets (C++11 弃用)(C++14 移除)	从 stdin 读取字符串 (函数)
putchar	写字符到 stdout (函数)
puts	写字符串到 stdout (函数)
ungetc	把字符放回文件流 (函数)
宽字符
fgetwcgetwc	从文件流获取宽字符 (函数)
fgetws	从文件流获取宽字符串 (函数)
fputwcputwc	写宽字符到文件流 (函数)
fputws	写宽字符串到文件流 (函数)
getwchar	从 stdin 读取宽字符 (函数)
putwchar	写宽字符到 stdout (函数)
ungetwc	把宽字符放回文件流 (函数)
有格式输入/输出
字节/多字节字符
scanffscanfsscanf	从 stdin、文件流或缓冲区读取有格式输入 (函数)
vscanfvfscanfvsscanf (C++11)(C++11)(C++11)	使用可变实参列表 从 stdin、文件流或缓冲区读取有格式输入 (函数)
printffprintfsprintfsnprintf (C++11)	打印有格式输出到 stdout、文件流或缓冲区 (函数)
vprintfvfprintfvsprintfvsnprintf (C++11)	使用可变实参列表 打印有格式输出到 stdout、文件流或缓冲区 (函数)
宽字符
wscanffwscanfswscanf	从 stdin、文件流或缓冲区读取有格式宽字符输入 (函数)
vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	使用可变实参列表 从 stdin、文件流或缓冲区读取有格式宽字符输入 (函数)
wprintffwprintfswprintf	打印有格式宽字符输出到 stdout、文件流或缓冲区 (函数)
vwprintfvfwprintfvswprintf	使用可变实参列表打印 有格式宽字符输出到 stdout、文件流或缓冲区 (函数)
文件寻位
ftell	返回当前文件位置指示器 (函数)
fgetpos	获取文件位置指示器 (函数)
fseek	移动文件位置指示器到文件中的指定位置 (函数)
fsetpos	移动文件位置指示器到文件中的指定位置 (函数)
rewind	移动文件位置指示器到文件起始 (函数)
错误处理
clearerr	清除错误 (函数)
feof	检查文件尾 (函数)
ferror	检查文件错误 (函数)
perror	显示对应当前错误的字符串于 stderr (函数)
文件上的操作
remove	删除文件 (函数)
rename	重命名文件 (函数)
tmpfile	创建并打开一个临时、自动移除的文件 (函数)
tmpnam	返回一个唯一独有的文件名 (函数)

宏常量

在标头 <cstdio> 定义
EOF	拥有 int 类型和负值的整数常量表达式 (宏常量)
FOPEN_MAX	能同时打开的文件数 (宏常量)
FILENAME_MAX	要保有最长受支持文件名的 char 数组所需的长度 (宏常量)
BUFSIZ	std::setbuf 所用的缓冲区大小 (宏常量)
_IOFBF_IOLBF_IONBF	给 std::setbuf 的实参，指示全缓冲输入/输出 给 std::setbuf 的实参，指示行缓冲输入/输出 给 std::setbuf 的实参，指示无缓冲输入/输出 (宏常量)
SEEK_SETSEEK_CURSEEK_END	给 std::fseek 的实参，指示从文件起始寻位 给 std::fseek 的实参，指示从当前文件位置寻位 给 std::fseek 的实参，指示从文件尾寻位 (宏常量)
TMP_MAX	std::tmpnam 所能生成的唯一文件名的最大数量 (宏常量)
L_tmpnam	保有 std::tmpnam 结果的 char 数组所需的大小 (宏常量)

参阅

文件输入/输出的 C 文档