basic_istream 類別

發行項
06/09/2015

描述物件項目的控制項擷取並輸入資料流緩衝區的物件與 Elem型別，也稱為 char_type的項目，類別取決於性格特性 Tr，也稱為 traits_type。

template <class Elem, class Tr = char_traits<Elem> > 
   class basic_istream 
      : virtual public basic_ios<Elem, Tr>

備註

大部分成員函式多載運算子>> 是格式化輸入函式。它們遵循模式:

    iostate state = goodbit;
    const sentry ok(*this);
    if (ok)
        {try
            {<extract elements and convert
            accumulate flags in state
            store a successful conversion> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);
    return (*this);

許多其他成員函式是未格式化的輸入函式。它們遵循模式:

    iostate state = goodbit;
    count = 0;    // the value returned by gcount
    const sentry ok(*this, true);
    if (ok)
        {try
            {<extract elements and deliver
            count extracted elements in count
            accumulate flags in state> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);

函式呼叫 setstate(eofbit) 的兩個群組，如果遇到檔案結尾，在擷取項目時。

類別 basic_istream<則為Elem， Tr> 物件儲存:

basic_ios<類別Elem， Tr>.公用虛擬基底物件
最後一個未格式化的輸入作業的擷取計數 (呼叫在上述程式碼的 count )。

範例

請參閱 basic_ifstream 類別範例進一步了解輸入資料流。

建構函式

basic_istream

建構屬於 basic_istream 類型的物件。

成員函式

gcount	傳回在最後一個未格式化的輸入期間讀取的字元數。
get	從輸入資料流讀取的一或多個字元。
getline	從輸入資料流讀取的資料行。
ignore	造成一些項目從目前的讀取位置略過。
窺視	傳回要讀取的下一個字元。
放回	將指定的字元輸入資料流。
read	陣列中的指定字元數來自資料流的並儲存它們。
readsome	讀取的緩衝區。
seekg	移至資料流的讀取位置。
哨兵	巢狀類別描述宣告結構格式輸入函式和未格式化的輸入函式的物件。
交換	為提供的 basic_istream 物件參數交換這個 basic_istream 物件。
同步處理	同步處理輸入裝置相關聯的資料流的緩衝資料流。
tellg	報告資料流中目前的讀取位置。
unget	將最近讀取的字元至資料流。

運算子

運算子>>	會在輸入資料流的函式或讀取輸入資料流的格式化資料。
operator=	在運算子右方的 basic_istream 指派給這個物件。這是包含不保留複製後邊的 rvalue 參考的移動工作。