Freigeben über


basic_istream-Klasse

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.

Anforderungen

Header: <istream>

Namespace: std

Siehe auch

Referenz

Threadsicherheit in der C++-Standardbibliothek

iostream-Programmierung

iostreams-Konventionen

Weitere Ressourcen

basic_istream Member

<istream> Member