std::basic_streambuf<CharT,Traits>::showmanyc

protected: virtual std::streamsize showmanyc();

関連する文字シーケンスで入力可能な文字数を推定します。 underflow() は、少なくともその数の文字が抽出されるまで、Traits::eof() を返したり、例外をスローしたりすることが保証されていません。

関連する文字シーケンスで確実に利用可能な文字数、またはブロックせずに文字が利用可能でないことを判断できる場合は -1 です。 showmanyc が -1 を返した場合、 underflow() および uflow() は確実に Traits::eof を返すか、例外をスローします。

基底クラスのバージョンは 0 を返し、これは「関連シーケンスで文字が利用可能かどうか不明」という意味です。

この関数の名前は「stream: how many characters?」の略であり、「show many C」ではなく「S how many C」と発音します。

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 159	C++98	underflow() は、〜まで失敗しないことが保証されています。少なくとも `showmanyc()` 文字が供給される	少なくとも〜を許可するように保証を拡張しました。 `showmanyc()` 文字を抽出できる

in_avail	取得領域ですぐに利用可能な文字数を取得する (public member function) [編集]
showmanyc [virtual]	ファイルからの入力に利用可能な文字数をオプションで提供します。 (virtual protected member function of `std::basic_filebuf<CharT,Traits>`) [編集]

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

目次