basic_istream Class

發行項
03/28/2013

描述物件來控制擷取的項目，以及從具有元素型別的資料流緩衝區的編碼的物件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) 如果在擷取的項目遇到檔案結尾。

An object of class basic_istream<Elem, Tr> 儲存區:

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

範例

請參閱範例的basic_ifstream Class若要深入了解輸入資料流。

建構函式

basic_istream

建構型別的物件basic_istream。

成員函式

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

運算子

運算子 >>	在輸入資料流上呼叫函式，或輸入資料流中讀取已格式化的資料。
operator=	會指定basic_istream的運算子，對此物件的右邊。這是移動的工作分派涉及rvalue不會留下複本的參考。