basic_istream Class

Artikel
03/15/2013

Beschreibt ein Objekt, das Extrahieren von Elementen steuert und codierte Objekte aus einem Streampuffer mit Elementen des Typs Elem, auch bekannt als Char_type, deren Eigenschaften hängen von der Klasse Tr, auch bekannt als Traits_type.

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

Hinweise

Die meisten Mitgliedstaaten funktioniert diese Überladung Operator >> input Funktionen formatiert sind.Sie folgen dem Muster:

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

Viele andere Memberfunktionen sind unformatierte input-Funktion.Sie folgen dem Muster:

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

Beide Gruppen von Funktionen Call Setstate(Eofbit) Wenn sie Ende der Datei beim Extrahieren der Elemente auftreten.

An object of class basic_istream<Elem, Tr> speichert:

Virtuelle öffentliche Basis-Objekt der Klasse Basic_ios<Elem, Tr>.
Eine Extraktion Count für die letzten unformatierte input-Operation (genannt Count im vorherigen Code).

Beispiel

Siehe das Beispiel für basic_ifstream Class Weitere Informationen zu Eingabestreams.

Konstruktoren

basic_istream

Erstellt ein Objekt vom Typ basic_istream.

Member-Funktionen

gcount	Gibt die Anzahl der Zeichen während der letzten unformatierte Eingabe gelesen.
abrufen	Liest ein oder mehrere Zeichen aus dem Eingabestream.
getLine	Liest eine Zeile aus dem Eingabestream.
ignore	Bewirkt, dass eine Anzahl von Elementen aus die aktuelle Leseposition übersprungen werden.
Peek	Gibt das nächste Zeichen gelesen werden.
putback	Fügt ein angegebenes Zeichen in den Stream.
read	Liest eine angegebene Anzahl von Zeichen aus dem Stream und speichert diese in einem Array.
Characters	Lesen von nur Puffer.
seekg	Verschiebt die Lese Position in einem Stream.
Sentry	Die geschachtelte Klasse beschreibt ein Objekt, dessen Deklaration der formatierten input und die unformatierten input Funktionen Strukturen.
Swap	Tauscht diese basic_istream -Objekt für den bereitgestellten basic_istream Parameter-Objekt.
Sync	Synchronisiert das Eingabegerät den Stream mit der Streampuffer zugeordnet.
tellg	Meldet die aktuelle Position im Stream lesen.
unget	Puts lesen die zuletzt Zeichen wieder in den Stream.

Operatoren

Operator >>	Ruft eine Funktion auf dem Eingabestream oder liest formatierte Daten aus dem Eingabestream.
operator=	Weist den basic_istream auf der rechten Seite des Operators, der dieses Objekt.Dies ist eine Zuordnung Verschieben mit einer rvalue Referenz, die keine Kopie hinterlassen wird.