basic_istream Class

Článek
03/15/2013

Popisuje objekt, který řídí extrakce prvky a objekty kódovaného z vyrovnávací paměti datového proudu s prvky typu Elem, také známé jako char_type, jehož znaky znakem jsou určena třída Tr, také známé jako traits_type.

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

Poznámky

Většina členské funkce že přetížení operátor >> jsou formátovány vstupní funkce.Jsou podle vzorce:

    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);

Mnoho funkcí členů je neformátovaný vstupní funkce.Jsou podle vzorce:

    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);

Obě skupiny volání funkce setstate(eofbit) Pokud narazí při extrahování prvků na konec souboru.

An object of class basic_istream<Elem, Tr> úložiště:

Virtuální veřejné základní objekt třídy basic_ios<Elem, Tr>.
Extrakci počet pro poslední operaci neformátovaný vstupní (nazývané počet v předchozím kódu).

Příklad

Viz příklad pro basic_ifstream Class Další informace o vstupních proudů.

Konstruktory

basic_istream

Vytvoří objekt typu basic_istream.

Funkce členů

gcount	Vrátí počet znaků čtení během poslední neformátovaný vstup.
získat	Jeden nebo více znaků přečte ze vstupního datového proudu.
getline	Přečte řádek ze vstupního datového proudu.
Ignorovat	Způsobí, že počet prvků přeskočit z aktuální pozice čtení.
Náhled	Vrátí následující znak ke čtení.
putback	Vloží zadaný znak do proudu.
čtení	Načte zadaný počet znaků z proudu a ukládá je v matici.
readsome	Číst pouze vyrovnávací paměti.
seekg	Čtení přesune do proudu.
SENTRY	Popisuje vnořené třídy objektu, jehož prohlášení struktur formátovaný vstupní funkce a neformátovaný vstupní funkce.
Zaměnit	Výměny to basic_istream zadaný objekt basic_istream parametr objektu.
synchronizace	Synchronizuje vstupní zařízení přidružené k datovému proudu pomocí vyrovnávací paměti datového proudu.
tellg	Zprávy číst aktuální pozici v proudu.
unget	Znak uvede naposledy číst zpět do proudu.

Operátory

operátor >>	Volání funkce ve vstupním datovém proudu nebo čte formátovaná data ze vstupní proud.
operátor =	Přiřadí basic_istream na pravé straně operátoru k tomuto objektu.Je zahrnující přesunout přiřazení rvalue odkaz, který nesmí opustit kopii za.