basic_istream-Klasse

Artikel
06/09/2015

Beschreibt ein Objekt, das von Extraktions- Elementen und kodierter Objekte eines Streampuffer mit Elementen des Typs Elem steuert, auch char_type, dessen Zeichenmerkmale durch die Klasse Tr bestimmt werden, der auch unter traits_type.

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

Hinweise

Die meisten Memberfunktionen, die Operator >>, sind überladen formatierte Eingabefunktionen. 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 anderen Memberfunktionen sind unformatierte Eingabefunktionen. 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 Funktionen rufen setstate auf (eofbit) wenn sie Dateiende beim Extrahieren der Elemente finden.

Ein Objekt der Klasse basic_istream<,ElemTr> speichert:

Ein virtuelles öffentliches Basisobjekt der Klasse basic_ios<Elem, Tr>.
Eine Extraktionsanzahl für die letzte Eingabeoperation unformatierte (genannt count im vorherigen Code).

Beispiel

Im Beispiel für basic_ifstream-Klasse, um mehr über Eingabestreams zu erfahren.

Konstruktoren

basic_istream

Konstruiert ein Objekt vom Typ basic_istream.

Memberfunktionen

gcount	Gibt die Zahl des Zeichenlesens während der letzten Speicherung Eingabe zurück.
get	Liest ein oder mehrere Zeichen im Eingabestream.
getline	Liest eine Zeile des Eingabestreams.
ignore	Veranlasst Einige Elemente, aus der aktuellen Leseposition übersprungen werden.
flüchtiger Blicker flüchtiger Blick	Gibt das nächste zu lesende Zeichen, zurück.
Putback	Setzt ein angegebenes Zeichen in den Stream.
read	Liest eine angegebene Zeichenanzahl dem Stream und speichert sie in ein Array.
readsome	Lesen nur aus dem Puffer.
seekg	Verschiebt die Leseposition in einem Stream.
Wache	Die geschachtelte Klasse beschreibt ein Objekt, dessen Deklaration die formatierten Eingabefunktionen und die unformatierten Eingabefunktionen strukturiert.
swap	Vertauscht dieses basic_istream-Objekt für den bereitgestellten basic_istream-Objektparameter aus.
Synchronisierung	Synchronisiert das Eingabegerät, das dem Stream mit dem Puffer des Streams zugeordnet ist.
tellg	Meldet die aktuelle Leseposition im Stream.
unget	Setzt das zuletzt Lesezeichen zurück in den Stream.

Operatoren

Operator implementiert.>>	Ruft eine Funktion auf dem Eingabestream auf oder liest formatierte Daten im Eingabestream.
operator=	Weist basic_istream auf der rechten Seite des Operators mit diesem Objekt zu. Dies ist eine Verschiebungszuweisung, die einen Verweis mit rvalue ein, der keine Kopie zurückläßt.