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

返回最后一次 无格式输入操作 所提取的字符数量，若该数值无法表示则返回 std::streamsize 的最大可表示值。

以下 basic_istream 的成员函数会改变后续 gcount() 调用的返回值：

• 移动构造函数
• swap()
• get()
• getline()
• ignore()
• read()
• readsome()
• operator>>(basic_streambuf*)

以下函数会将 gcount() 设置为零：

• 构造函数
• putback()
• unget()
• peek()

参数

(无)

返回值

上一次无格式输入操作提取的字符数量，若该数值无法表示则为 std::streamsize 的最大可表示值。

示例

#include <iostream>
#include <sstream>
int main()
{
    char x[20];
    std::istringstream stream("Hello World");
    stream.read(x, sizeof x);
    std::cout << "Characters extracted: " << stream.gcount();
}

Characters extracted: 11

缺陷报告

下列行为变更缺陷报告被追溯应用于先前发布的C++标准。