std::basic_istream<CharT,Traits>::readsome
来自 cppreference.cn
< cpp | io | basic istream
| std::streamsize readsome( char_type* s, std::streamsize count ); |
||
从输入流中提取最多 count 个立即可用的字符。提取的字符存储到 s 所指向的字符数组中。
行为如 UnformattedInputFunction。在构造并检查哨兵对象后：
- 如果 rdbuf()->in_avail() == -1，则调用 setstate(eofbit) 且不提取任何字符。
- 如果 rdbuf()->in_avail() == 0，则不提取任何字符。
- 如果 rdbuf()->in_avail() > 0，则提取 std::min(rdbuf()->in_avail(), count) 个字符，并将它们存储到 s 指向的字符数组的连续位置。
目录 |
[编辑] 参数
| s | - | 指向字符数组的指针，用于存储字符 |
| count | - | 要读取的最大字符数 |
[编辑] 返回值
实际提取的字符数。
[编辑] 异常
如果内部操作抛出异常，则捕获该异常并设置 badbit。如果 exceptions() 为 badbit 设置，则重新抛出异常。
[编辑] 注意
此函数的行为高度依赖于实现。例如，将 readsome() 与 std::ifstream 一起使用会导致显著的、依赖于实现的结果。一些库实现在 std::ifstream 打开文件后立即用数据填充底层 filebuf，这意味着 readsome() 总是读取数据，甚至可能读取整个文件。在其他实现中，std::ifstream 仅在调用输入操作时才从文件中读取，这意味着在打开文件后立即调用 readsome() 永远不会提取任何字符。类似地，调用 std::cin.readsome() 可能会返回所有待处理、未处理的控制台输入，也可能始终返回零且不提取任何字符。
[编辑] 示例
运行此代码
#include <cassert> #include <iostream> #include <sstream> int main() { char c[10] = "*********"; // c[9] == '\0' // std::stringbuf makes its entire buffer available for unblocking read std::istringstream input("This is sample text."); auto r = input.readsome(c, 5); // reads 'This ' and stores in c[0] .. c[4] assert(r == 5); std::cout << c << '\n'; r = input.readsome(c, 9); // reads 'is sample' and stores in c[0] .. c[8] assert(r == 9); std::cout << c << '\n'; }
输出
This **** is sample
[编辑] 参阅
| 提取字符块 (公共成员函数) | |
| 获取获取区中立即可用的字符数 ( std::basic_streambuf<CharT,Traits> 的公共成员函数) |
