std:: istream_iterator

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Iterator-Bibliothek

Iterator-Konzepte
indirectly_readable (C++20) indirectly_writable (C++20) weakly_incrementable (C++20) incrementable (C++20) is-integer-like is-signed-integer-like (C++20)(C++20)	sentinel_for (C++20) sized_sentinel_for (C++20) input_iterator (C++20) output_iterator (C++20) input_or_output_iterator (C++20)	forward_iterator (C++20) bidirectional_iterator (C++20) random_access_iterator (C++20) contiguous_iterator (C++20)
Iterator-Primitive
input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tagcontiguous_iterator_tag (C++20)	iter_value_titer_difference_titer_reference_titer_const_reference_titer_rvalue_reference_titer_common_reference_t (C++20)(C++20)(C++20)(C++23)(C++20)(C++20)	iterator (veraltet in C++17) iterator_traits incrementable_traits (C++20) indirectly_readable_traits (C++20)
Algorithmus-Konzepte und Hilfsprogramme
Indirekte aufrufbare Konzepte
indirectly_unary_invocableindirectly_regular_unary_invocable (C++20)(C++20)	indirect_unary_predicate (C++20) indirect_binary_predicate (C++20)	indirect_equivalence_relation (C++20) indirect_strict_weak_order (C++20)
Gemeinsame Algorithmus-Anforderungen
indirectly_movable (C++20) indirectly_movable_storable (C++20) indirectly_copyable (C++20)	indirectly_copyable_storable (C++20)   indirectly_swappable (C++20) indirectly_comparable (C++20)	permutable (C++20) mergeable (C++20) sortable (C++20)
Dienstprogramme
indirect_result_t (C++20)	projected (C++20)	projected_value_t (C++26)
Iterator-Adapter
reverse_iterator make_reverse_iterator (C++14) move_iterator (C++11) make_move_iterator (C++11) default_sentinel_tdefault_sentinel (C++20)(C++20) unreachable_sentinel_tunreachable_sentinel (C++20)(C++20)	front_insert_iterator back_insert_iterator inserter insert_iterator front_inserter back_inserter move_sentinel (C++20)	common_iterator (C++20) counted_iterator (C++20) basic_const_iterator (C++23) const_iterator (C++23) const_sentinel (C++23) make_const_iterator (C++23) make_const_sentinel (C++23)
Stream-Iteratoren istream_iterator    ostream_iterator istreambuf_iterator ostreambuf_iterator	Iterator-Anpassungspunkte ranges::iter_move (C++20) ranges::iter_swap (C++20)
Iterator-Operationen advance distance prev (C++11)   next (C++11) ranges::advance (C++20) ranges::distance (C++20) ranges::prev (C++20) ranges::next (C++20)	Bereichszugriff begincbegin (C++11)(C++14) rbegincrbegin (C++14)(C++14)   endcend (C++11)(C++14) rendcrend (C++14)(C++14)   sizessize (C++17)(C++20) empty (C++17) data (C++17)

 

std::istream_iterator

Memberfunktionen

istream_iterator::istream_iterator

istream_iterator::~istream_iterator

istream_iterator::operator*istream_iterator::operator->

istream_iterator::operator++istream_iterator::operator++(int)

Nicht-Member-Funktionen

operator==operator!= (bis C++20)

 

Definiert in Header <iterator>
template< class T,           class CharT = char,           class Traits = std::char_traits<CharT>,           class Distance = std::ptrdiff_t > class istream_iterator     : public std::iterator<std::input_iterator_tag, T, Distance, const T*, const T&>		(bis C++17)
template< class T,           class CharT = char,           class Traits = std::char_traits<CharT>,           class Distance = std::ptrdiff_t > class istream_iterator;		(seit C++17)

std::istream_iterator ist ein Single-Pass-Eingabeiterator, der sukzessive Objekte vom Typ T aus dem std::basic_istream-Objekt liest, für das er konstruiert wurde, indem der entsprechende operator>> aufgerufen wird. Die eigentliche Lesoperation wird beim Inkrementieren des Iterators ausgeführt, nicht beim Dereferenzieren. Das erste Objekt wird beim Konstruieren des Iterators gelesen. Das Dereferenzieren gibt nur eine Kopie des zuletzt gelesenen Objekts zurück.

Der Standardkonstruktor von std::istream_iterator wird als End-of-Stream-Iterator bezeichnet. Wenn ein gültiger std::istream_iterator das Ende des zugrunde liegenden Streams erreicht, wird er gleich dem End-of-Stream-Iterator. Das Dereferenzieren oder weitere Inkrementieren ruft undefiniertes Verhalten hervor. Ein End-of-Stream-Iterator bleibt im End-of-Stream-Zustand, auch wenn sich der zugrunde liegende Streamzustand ändert. Ohne eine Neuzuweisung kann er nicht mehr zu einem Nicht-End-of-Stream-Iterator werden.

Eine typische Implementierung von std::istream_iterator speichert zwei Datenmember: einen Zeiger auf das zugehörige std::basic_stream-Objekt und den zuletzt gelesenen Wert vom Typ T.

T muss die Anforderungen DefaultConstructible, CopyConstructible und CopyAssignable erfüllen.

Member-Typen

Mitgliedertyp	Definition
iterator_category	std::input_iterator_tag
value_type	T
difference_type	Distance
Zeiger	const T*
Referenz	const T&
char_type	CharT
traits_type	Traits
istream_type	std::basic_istream<CharT, Traits>

Die Membertypen iterator_category, value_type, difference_type, pointer und reference müssen durch Vererbung von std::iterator<std::input_iterator_tag, T, Distance, const T*, const T&> bezogen werden.

(bis C++17)

Memberfunktionen

(Konstruktor)	konstruiert einen neuen istream_iterator (public member function)
(Destruktor)	destruiert einen istream_iterator, einschließlich des gecachten Werts (public member function)
operator*operator->	gibt das aktuelle Element zurück (public member function)
operator++operator++(int)	bewegt den Iterator vorwärts (public member function)

Nicht-Member-Funktionen

operator==operator!= (in C++20 entfernt)

vergleicht zwei istream_iterators (function template)

Hinweise

Beim Lesen von Zeichen überspringt std::istream_iterator standardmäßig Leerzeichen (es sei denn, dies wird mit std::noskipws oder Äquivalenten deaktiviert), während std::istreambuf_iterator dies nicht tut. Darüber hinaus ist std::istreambuf_iterator effizienter, da er den Overhead für die Konstruktion und Destruktion des Sentry-Objekts einmal pro Zeichen vermeidet.

Beispiel

Führen Sie diesen Code aus

#include <algorithm>
#include <iostream>
#include <iterator>
#include <numeric>
#include <sstream>
 
int main()
{
    std::istringstream str("0.1 0.2 0.3 0.4");
    std::partial_sum(std::istream_iterator<double>(str),
                     std::istream_iterator<double>(),
                     std::ostream_iterator<double>(std::cout, " "));
 
    std::istringstream str2("1 3 5 7 8 9 10");
    auto it = std::find_if(std::istream_iterator<int>(str2),
                           std::istream_iterator<int>(),
                           [](int i){ return i % 2 == 0; });
 
    if (it != std::istream_iterator<int>())
        std::cout << "\nThe first even number is " << *it << ".\n";
    //" 9 10" left in the stream
}

Ausgabe

0.1 0.3 0.6 1 
The first even number is 8.

Defect reports

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
P0738R2	C++98	der erste Lesevorgang könnte auf die erste Dereferenzierung verschoben werden	wird immer im Konstruktor ausgeführt

Siehe auch

ostream_iterator	Ausgabe-Iterator, der in std::basic_ostream schreibt (Klassenvorlage)
istreambuf_iterator	Eingabe-Iterator, der aus std::basic_streambuf liest (Klassenvorlage)