C++ 标准库的 C I/O 子集实现 C 风格流输入/输出操作。 <cstdio> 头文件提供通用文件支持并提供有窄和多字节字符输入/输出能力的函数,而 <cwchar>头文件提供有宽字符输入/输出能力的函数。 从
直接输入/输出
文件读取
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;
}