std::basic_istream::gcount

streamsize gcount();

概要

最後に実行した非書式化入力関数での入力文字数を取得する。

戻り値

最後に実行した非書式化関数での入力文字数。

入力文字数がstreamsizeで表現できる範囲を超える場合の扱いは、バージョンによって異なる。

• C++03 : 規定されていない
• C++23 : その文字数がnumeric_limits<streamsize>::max()を超える場合は、numeric_limits<streamsize>::max()を返す

例

readメンバ関数の例を参照。

バージョン

言語

• C++98

参照

• LWG Issue 3464. istream::gcount() can overflow
  • C++23で、抽出文字数がstreamsizeで表現できない場合にnumeric_limits<streamsize>::max()を返すことが規定された