C 风格文件输入/输出

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

C 流是 std::FILE 类型对象，只能通过 std::FILE* 类型指针访问及操作（注意：在可能以解引用合法的 std::FILE* ，复制创建 std::FILE 类型的局部对象时，在 I/O 函数使用这种副本的地址是未定义行为）。每个 C 流与外部物理设备（文件、标准输入流、打印机、序列端口等）关联。

C 流能用于无格式和有格式的输入及输出。它们对本地环境敏感，并可在需要时提供宽/多字节转换。不同于关联到其自身本地环境的 C++ 流，所有 C 流都访问同一本地环境对象：最近 std::setlocale 所安装者。

除了访问设备所必须的系统限定信息（例如 POSIX 文件描述符），每个 C 流对象保有以下内容：

窄与宽面向

新打开的流无面向。首次到 std::fwide 的调用或 I/O 函数建立面向：宽 I/O 函数令流为宽面向，窄 I/O 函数令流为窄面向。一旦设置，则面向只能以 std::freopen 更改。不能在宽面向流上调用窄 I/O 函数，不能在窄面向流上调用宽 I/O 函数。宽 I/O 函数在宽与多字节字符间如同以调用 std::mbrtowc 和 std::wcrtomb 转换。不同于程序中合法的多字节字符串，文件中的多字节字符可以含有嵌入的空字符且不必以初始迁移状态开始或结束。

POSIX 要求在流对象的面向变成宽时，将当前安装的 C 本地环境的 LC_CTYPE 平面存储于其中，而且将它用于此流上的所有将来 I/O 直至面向被更改，无关乎任何到 std::setlocale 的后继调用。

二进制与文本模式

文本流是被组合进行（零或更多字符加上终止的 '\n' ）的有序字符序列。最后一行是否要求终止的 '\n' 是实现定义的。可能必须在输入与输出时添加、切换或删除字符，以符合 OS 中的表示文本（尤其是 Windows OS 上的 C 流在输出时将 \n 转换为 \r\n ，输入时将 \r\n 转换为 \n ）。

仅若下列条件全为真，从文本流读取的数据才保证与先前写出到该文本流者比较相等：

• 数据只由打印字符和控制字符 \t 及 \n 组成（尤其是 Windows OS 上，字符 '\0x1A' 终止输入）
• 没有 \n 立即前附空格符（立即先于 \n 写入的空格符可能在读取时消失）
• 尾字符是 \n

二进制流是能通透地记录内部数据的有序字符序列。从二进制流读取的数据始终与先前写出到该流者比较相等。仅允许实现后附一些空字符到流结尾。宽二进制流不必终止于初始迁移状态。

POSIX 实现不辨别文本与二进制流（无 \n 或任何其他字符的特殊映射）。

函数

类型

宏

参阅