std::streambuf::showmanyc

streamsize showmanyc();

獲取可用字元數

由其他成員函式呼叫的虛擬函式（讀作 s-how-many-c），用於估算關聯輸入序列中可用的字元數。

當輸入指標（gptr）沒有可讀位置時，它會被公共成員函式 streambuf::in_avail 呼叫。

返回值提供了關於受保護成員函式 underflow 和 uflow 可能行為的資訊。

返回值	描述	`underflow` 和 `uflow` 的預期行為
`>0`	已知可用字元數	連續呼叫將成功提取字元，直到提取的字元數至少與返回的值一樣多。
`0`	無資訊	後續呼叫可能會檢索更多字元，或者返回 `traits_type::eof()`。
`-1`	序列不可用	後續呼叫將失敗（可能丟擲異常或“立即”返回）。

在 streambuf 中，其預設行為是始終返回零。filebuf 會覆蓋此成員函式（參見 filebuf::showmanyc）。

引數

無

返回值

返回零。
streamsize 是一個帶符號整型。

資料競爭

不引入資料競爭，但派生類中重寫的版本可能會。

異常安全

無異常保證：此預設定義從不丟擲異常。

另見

streambuf::in_avail: 獲取可供讀取的字元數 (公有成員函式)

streambuf::underflow: 在下溢時獲取字元 (保護虛成員函式)

streambuf::uflow: 在下溢時獲取字元並前進位置 (保護虛成員函式)

filebuf::showmanyc: 獲取可用字元數 (保護虛成員函式)

公有成員

受保護成員

虛保護成員

std::streambuf::showmanyc

引數

返回值

資料競爭

異常安全

另見