std::basic_istream<CharT,Traits>::readsome

< cpp‎ | io‎ | basic istream
 
C++
 
输入/输出库
 
std::basic_istream
 
std::streamsize readsome( char_type* s, std::streamsize count );

从输入流释出至多 count 个立即可用的字符。存储释出的字符于 s 所指向的字符数组。

表现为无格式输入函数 (UnformattedInputFunction) 。构造并检查 sentry 对象后，

  • 若 rdbuf()->in_avail() == -1 ，则调用 setstate(eofbit) 而不释出字符。
  • 若 rdbuf()->in_avail() == 0 ，则不释出字符。
  • 若 rdbuf()->in_avail() > 0 ，则释出 std::min(rdbuf()->in_avail(), count) 个字符，并存储它们到首元素为 s 所指向的字符数组的相继位置。

参数

s - 指向要存储字符到的字符数组的指针
count - 要读取的最大字符数

返回值

实际释出的字符数。

异常

若出现错误（错误状态标志不是 goodbit ）并且设置了 exceptions() 为对该状态抛出则为 failure 。

若内部操作抛出异常，则捕获它并设置 badbit 。若对 badbit 设置了 exceptions() ，则重抛该异常。

注意

此函数的行为是高度实现限定的。例如，以 std::ifstream 使用时，某些库实现在文件打开时立即以数据填充底层 filebuf （而这种实现上 readsome() 读取的数据潜在地，但不必为整个文件），而其他实现仅在请求实际输入操作时从文件读取（而文件打开后立即作出的 readsome() 决不释出任何字符）。类似地，调用 std::cin.readsome() 可能返回所有悬置的未处理控制台输入，或可能始终返回零并且不释出字符。

示例

运行此代码
#include <iostream>
#include <sstream>
 
int main()
{
    char c[10] = {};
    std::istringstream input("This is sample text."); // std::stringbuf 令个缓冲可用于无阻塞读取
    input.readsome(c, 5); // 读取 'This ' 并存储于 c[0] .. c[4]
    input.readsome(c, 9); // 读取 'is sample' 并存储于 c[0] .. c[8]
    std::cout << c;
}

输出： 

is sample

参阅

 读并取走一块字符
(公开成员函数)
获得获取区中立即可用的字符数
(std::basic_streambuf<CharT,Traits> 的公开成员函数)