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++規格に対して遡及的に適用されました。