Namespaces
Variants

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

From cppreference.net
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> の仮想保護メンバ関数)