std::basic_streambuf<CharT,Traits>:: showmanyc
|
protected
:
virtual std:: streamsize showmanyc ( ) ; |
||
関連付けられた文字シーケンスからの入力で利用可能な文字数を推定します。 underflow() は、少なくともその数の文字が抽出されるまで、 Traits :: eof ( ) を返すことや例外をスローすることが保証されています。
目次 |
パラメータ
(なし)
戻り値
関連付けられた文字シーケンスで確実に利用可能な文字数、または
-
1
が
showmanyc
がブロックせずに文字が利用できないと判断できる場合。もし
showmanyc
が
-
1
を返す場合、
underflow()
と
uflow()
は確実に
Traits
::
eof
を返すか、例外をスローします。
基底クラスのバージョンは 0 を返します。これは「関連付けられたシーケンスに利用可能な文字があるかどうか不確か」という意味を持ちます。
注記
この関数名は「stream: how many characters?」を意味するため、「S how many C」と発音され、「show many C」とは発音されません。
例
|
このセクションは不完全です
理由: 例がありません |
欠陥報告
以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。
| DR | 適用対象 | 公開時の動作 | 正しい動作 |
|---|---|---|---|
| LWG 159 | C++98 |
underflow()
は少なくとも
showmanyc()
文字が供給されるまで
失敗しないことが保証されていた |
保証を拡張し、少なくとも
showmanyc()
文字を抽出できるようにした
|
関連項目
|
ゲット領域から即時利用可能な文字数を取得する
(公開メンバ関数) |
|
|
[virtual]
|
ファイルからの入力で利用可能な文字数を任意で提供する
( std::basic_filebuf<CharT,Traits>の仮想保護メンバ関数)
|