std::fread
来自 cppreference.cn
| 定义于头文件 <cstdio> |
||
| std::size_t fread( void* buffer, std::size_t size, std::size_t count, std::FILE* stream ); |
||
从给定的输入流 stream 读取至多 count 个对象到数组 buffer 中，就像对每个对象调用 std::fgetc size 次，并将结果按顺序存储到 buffer 的连续位置中，buffer 被重新解释为 unsigned char 数组。流的文件位置指示器将按读取的字符数前进。
如果对象不是 TriviallyCopyable 的，则行为未定义。
如果发生错误，流的文件位置指示器的最终值是不确定的。如果读取了部分元素，其值是不确定的。
目录 |
[编辑] 参数
| buffer | - | 指向要读取的数组中第一个对象的指针 |
| size | - | 每个对象的大小（以字节为单位） |
| count | - | 要读取的对象数量 |
| stream | - | 要从中读取的输入文件流 |
[编辑] 返回值
成功读取的对象数量，如果发生错误或到达文件末尾，则可能小于 count。
如果 size 或 count 为零，fread 返回零且不执行其他操作。
fread 不区分文件末尾和错误，调用者必须使用 std::feof 和 std::ferror 来确定发生了哪种情况。
[编辑] 示例
运行此代码
#include <cstddef> #include <cstdio> #include <fstream> #include <iomanip> #include <iostream> #include <vector> int main() { // Prepare file std::ofstream("test.txt") << 1 << ' ' << 2 << '\n'; std::FILE* f = std::fopen("test.txt", "r"); std::vector<char> buf(4); // char is trivially copyable const std::size_t n = std::fread(&buf[0], sizeof buf[0], buf.size(), f); std::cout << "Read " << n << " object" << (n > 1 ? "s" : "") << ": " << std::hex << std::uppercase << std::setfill('0'); for (char n : buf) std::cout << "0x" << std::setw(2) << static_cast<short>(n) << ' '; std::cout << '\n'; std::vector<std::string> buf2; // string is not trivially copyable // This would result in undefined behavior: // std::fread(&buf2[0], sizeof buf2[0], buf2.size(), f); }
可能的输出
Read 4 objects: 0x31 0x20 0x32 0x0A
[编辑] 参阅
| 从 stdin、文件流或缓冲区读取格式化输入 (函数) | |
| 从文件流获取字符字符串 (函数) | |
| 写入文件 (函数) | |
| C 文档 用于 fread
| |
