std::FILE

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (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 (until 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

 

定义于头文件 <cstdio>
typedef /* unspecified */ FILE;

每个 std::FILE 对象表示一个 C 流。

C 标准（C++ 标准引用）没有指定 std::FILE 是否是完整的对象类型。虽然可以复制有效的 std::FILE，但将指向此类副本的指针作为 I/O 函数的参数会调用未指定的行为。换句话说，std::FILE 在语义上可能不可复制。

I/O 流可用于非格式化和格式化输入和输出。此外，处理输入和输出的函数也可以是区域设置敏感的，以便在必要时执行宽/多字节转换。

流状态

除了访问设备所需的系统特定信息（例如，一个 POSIX 文件描述符），每个 std::FILE 对象直接或间接持有以下内容

1. 字符宽度：未设置、窄或宽。
2. 多字节和宽字符之间转换的解析状态（一个 std::mbstate_t 类型的对象）
3. 缓冲状态：无缓冲、行缓冲、全缓冲。
4. 缓冲区，可以由外部用户提供的缓冲区替换。
5. I/O 模式：输入、输出或更新（输入和输出）。
6. 二进制/文本模式指示符。
7. 文件结束状态指示符。
8. 错误状态指示符。
9. 文件位置指示符，可作为 std::fpos_t 类型的对象访问，对于宽流，它包括解析状态。
10. (C++17) 用于在多个线程读、写、定位或查询流位置时防止数据竞争的可重入锁。

窄和宽定向

新打开的流没有方向。首次调用 std::fwide 或任何 I/O 函数会建立方向：宽 I/O 函数使流宽定向；窄 I/O 函数使流窄定向。一旦设置，方向只能通过 std::freopen 更改。窄 I/O 函数不能在宽定向流上调用；宽 I/O 函数不能在窄定向流上调用。宽 I/O 函数在宽字符和多字节字符之间进行转换，就像通过调用 std::mbrtowc 或 std::wcrtomb 并使用流描述的转换状态一样。与程序中有效的多字节字符字符串不同，文件中的多字节字符序列可能包含嵌入的空字符，并且不必以初始移位状态开始或结束。

宽定向流的转换状态由流方向设置时安装的 C 区域设置确定。

二进制和文本模式

文本流是字符的有序序列，可以组成行；一行可以分解为零个或多个字符加上一个终止符 '\n'（“换行符”）。最后一行是否需要终止符 '\n' 是实现定义的。此外，为了符合操作系统中表示文本的约定，字符可能需要在输入和输出时添加、更改或删除（特别是，Windows 操作系统上的 C 流在输出时将 '\n' 转换为 '\r\n'，在输入时将 '\r\n' 转换为 '\n'）。

从文本流读取的数据只有在以下所有条件都为真时，才保证与之前写入该流的数据相等：

• 数据仅包含可打印字符和/或控制字符 '\t' 和 '\n'（特别是，在 Windows 操作系统上，字符 '\0x1A' 终止输入）。
• 没有 '\n' 字符紧跟在空格字符之后（这些空格字符在以后作为输入读取时可能会消失）。
• 最后一个字符是 '\n'。

二进制流是字符的有序序列，可以透明地记录内部数据。从二进制流读取的数据总是等于之前写入该流的数据，但实现可以向流的末尾追加不确定数量的空字符。宽二进制流不需要以初始移位状态结束。

注意

POSIX 明确要求当流的方向变为宽时，当前安装的 C 区域设置的 LC_CTYPE 方面必须存储在 FILE 对象中；POSIX 要求此 LC_CTYPE 方面用于此流上的所有未来 I/O，直到方向改变，无论之后是否调用 std::setlocale。

每个文本行都应该由本质上可供人阅读的数据组成。POSIX 实现不区分文本流和二进制流（对 '\n' 或任何其他字符没有特殊映射）。

另请参阅

basic_streambuf	抽象原始设备 (类模板)
basic_filebuf	实现原始文件设备 (类模板)
stdinstdoutstderr	与输入流关联的 FILE* 类型的表达式 与输出流关联的 FILE* 类型的表达式 与错误输出流关联的 FILE* 类型的表达式 (宏常量)
C 文档 用于 FILE