C++ 标准库的 C I/O 子集实现 C 风格流输入/输出操作。头文件提供通用文件支持并提供有窄和多字节字符输入/输出能力的函数,而 头文件提供有宽字符输入/输出能力的函数。 从
std::fread
从给定输入流 stream
读取至多 count
个对象到数组 buffer
中,如同以对每个对象调用 size
次 std::fgetc ,并按顺序存储结果到转译为 unsigned char 数组的 buffer
中的相继位置。流的文件位置指示器前进读取的字符数。
若对象不可平凡复制 (TriviallyCopyable) ,则行为未定义。
若出现错误,则流的文件位置指示器的结果值不确定。若读入部分的元素,则元素值不确定。
buffer | - | 指向要读取的数组中首个对象的指针 |
size | - | 每个对象的字节大小 |
count | - | 要读取的对象数 |
stream | - | 读取来源的输入文件流 |
成功读取的对象数,若出现错误或文件尾条件,则可能小于 count
。
若 size
或 count
为零,则 fread
返回零且不进行其他动作。
std::size_t fread( void* buffer, std::size_t size, std::size_t count, std::FILE* stream ); |
- #include <iostream>
- #include <cstdio>
- #include <fstream>
- #include <vector>
-
- int main()
- {
- // 准备文件
- std::ofstream("test.txt") << "hello " << ' ' << "word!" << std::endl;
- std::FILE* file = std::fopen("test.txt", "r");
-
- std::vector<char> buf(24); // char 可平凡复制
- std::fread(&buf[0], sizeof buf[0], buf.size(), file);
-
- for (char n : buf)
- {
- std::cout << n;
- }
-
- std::vector<std::string> buf2; // string 不可平凡复制
- // 这会导致未定义行为
- // std::fread(&buf2[0], sizeof buf2[0], buf2.size(), f);
- return 0;
- }
std::fwrite
std::size_t fwrite( const void* buffer, std::size_t size, std::size_t count, std::FILE* stream ); |
写 count
个来自给定数组 buffer
的对象到输出流stream
。如同转译每个对象为 unsigned char 数组,并对每个对象调用 size
次 std::fputc 以将那些 unsigned char 按顺序写入 stream
一般写入。文件位置指示器前进写入的字节数。
若对象不可平凡复制 (TriviallyCopyable) ,则行为未定义。
若出现错误,则文件位置指示器的结果值不确定。
buffer | - | 指向数组中要被写入的首个对象的指针 |
size | - | 每个对象的大小 |
count | - | 要被写入的对象数 |
stream | - | 指向输出流的指针 |
成功写入的对象数,若错误发生则可能小于 count
。
若 size
或 count
为零,则 fwrite
返回零并不进行其他行动。
- #include <cstdio>
- #include <vector>
- #include <array>
-
- int main()
- {
- // 写缓冲区到文件
- if (std::FILE* file1 = std::fopen("file.bin", "wb"))
- {
- std::array<int, 3> v = {42, -1, 7}; // std::array 的底层存储为数组
- std::fwrite(v.data(), sizeof v[0], v.size(), file1);
- std::fclose(file1);
- }
-
- // 读取同一数据并打印它到标准输出
- if (std::FILE *file2 = std::fopen("file.bin", "rb"))
- {
- std::vector<int> rbuf(10); // std::vector 的底层存储亦为数组
- std::size_t sz = std::fread(rbuf.data(), sizeof rbuf[0], rbuf.size(), file2);
- std::fclose(file2);
- for (std::size_t n = 0; n < sz; ++n)
- {
- std::printf("%d\n", rbuf[n]);
- }
- }
-
- return 0;
- }