istream_iterator-Klasse

Artikel
06/09/2015

Beschreibt ein Eingabeiteratorobjekt. Es werden Objekte der Klasse Type aus einem Eingabestream extrahiert. Der Zugriff darauf erfolgt durch ein gespeichertes Objekt vom Typ pointer auf basic_istream<CharType, Traits>.

template<class Type,
    class CharType = char,
    class Traits = char_traits<CharType>,
    class Distance = ptrdiff_t,
> class istream_iterator
 : public iterator<
        input_iterator_tag,
        Type, 
        Distance, 
        const Type *,
        const Type&
    >;

Parameter

Type
Der Typ des Objekts, das aus dem Eingabestream extrahiert werden soll.
CharType
Der Typ, der den Zeichentyp für istream_iterator darstellt. Dieses Argument ist optional, und der Standardwert ist char.
Traits
Der Typ, der den Zeichentyp für istream_iterator darstellt. Dieses Argument ist optional, und der Standardwert ist char_traits<CharType>.
Distance
Ein ganzzahliger Typ mit Vorzeichen, der den Differenztyp für den istream_iterator darstellt. Dieses Argument ist optional, und der Standardwert ist ptrdiff_t.

Nachdem ein Objekt der Klasse istream_iterator mit einem ungleich NULL gespeicherten Zeiger erstellt oder erhöht wurde, versucht das Objekt, ein Objekt vom Typ Type aus dem zugewiesenen Eingabestream zu extrahieren und zu speichern. Wenn die Extraktion fehlschlägt, ersetzt das Objekt den gespeicherten Zeiger durch einen NULL-Zeiger und erstellt so einen Indikator für das Ende der Sequenz.

Konstruktoren

istream_iterator

Erstellt entweder einen End-of-Stream-Iterator als Standard-istream_iterator oder ein istream_iterator, der für den Streamtyp des Iterators initialisiert wird, von dem gelesen wird.

Typedefs

char_type	Ein Typ, der für den Zeichentyp von istream_iterator bereitgestellt wird.
istream_type	Ein Typ, der für den Streamtyp von istream_iterator bereitgestellt wird.
traits_type	Ein Typ, der für den Merkmaltyp von istream_iterator bereitgestellt wird.

Operators

operator*	Der Dereferenzierungsoperator gibt das gespeicherte Objekt vom Typ Type zurück, das vom istream_iterator adressiert wird.
Operator->	Gibt den Wert eines Members zurück, falls vorhanden.
operator++	Extrahiert entweder ein inkrementiertes Objekt im Eingabestream oder kopiert das Objekt vor dem Inkrementieren und gibt die Kopie zurück.