C++

參考

<fstream>

basic_filebuf

public member function
<fstream>

std::basic_filebuf::showmanyc

streamsize showmanyc();
獲取可用字元數
返回關聯檔案中可用的字元數量的估計值。

此函式預計返回零（不提供任何資訊），但庫實現可能會提供有關對受保護成員函式 underflow 和 uflow 的未來呼叫的可能行為的資訊。
返回值描述underflow 和 uflow 的預期行為
>0已知可用字元數連續呼叫將成功提取字元，直到提取的字元數至少與返回的值一樣多。
0無資訊進一步的呼叫可能會檢索更多字元或返回 traits_type::eof()。
-1序列不可用後續呼叫將失敗（可能丟擲異常或“立即”返回）。

此虛成員函式覆蓋了繼承的成員 basic_streambuf::showmanyc，當 *get pointer*（gptr）處沒有可用的讀取位置時，由成員 in_avail 呼叫。

引數

無

返回值

返回零（如果不提供資訊）。
庫實現可能會返回不同的值來提供額外資訊。
streamsize 是一個帶符號整型。

資料競爭

未指定。

異常安全

基本保證：如果丟擲異常，*檔案流緩衝區*處於有效狀態。

另見

basic_filebuf::underflow
在下溢時獲取字元 (保護虛成員函式)
basic_filebuf::uflow
在上溢時獲取字元並前進位置 (受保護的虛成員函式)
basic_streambuf::showmanyc
獲取可用字元數 (保護虛成員函式)