std::istreambuf_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::istreambuf_iterator

Memberfunktionen

istreambuf_iterator::istreambuf_iterator

istreambuf_iterator::operator*

istreambuf_iterator::operator++istreambuf_iterator::operator++(int)

istreambuf_iterator::equal

Nicht-Member-Funktionen

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

 

Definiert in Header <iterator>
template< class CharT, class Traits = std::char_traits<CharT> > class istreambuf_iterator     : public std::iterator<std::input_iterator_tag,                            CharT, typename Traits::off_type,                            /* nicht spezifiziert */, CharT>		(bis C++17)
template< class CharT, class Traits = std::char_traits<CharT> > class istreambuf_iterator;		(seit C++17)

std::istreambuf_iterator ist ein Ein-Durchlauf-Eingabe-Iterator, der sukzessive Zeichen aus dem std::basic_streambuf-Objekt liest, für das er konstruiert wurde.

Der standardkonstruierte std::istreambuf_iterator wird als End-of-Stream-Iterator bezeichnet. Wenn ein std::istreambuf_iterator das Ende des zugrunde liegenden Streams erreicht, wird er gleich dem End-of-Stream-Iterator. Das Dereferenzieren oder Inkrementieren ruft undefiniertes Verhalten auf.

std::istreambuf_iterator hat einen trivialen Kopierkonstruktor, einen constexpr-Standardkonstruktor und einen trivialen Destruktor.

(seit C++11)

Member-Typen

Mitgliedertyp	Definition
iterator_category	std::input_iterator_tag
value_type	CharT
difference_type	typename Traits::off_type
Zeiger	/* nicht spezifiziert */
Referenz	CharT
char_type	CharT
traits_type	Traits
int_type	typename Traits::int_type
streambuf_type	std::basic_streambuf<CharT, Traits>
istream_type	std::basic_istream<CharT, Traits>
/* Proxy */	Implementierungsdefinierten Klassentyp. Ein Proxy-Objekt speichert ein char_type-Zeichen und einen streambuf_type*-Zeiger. Das Dereferenzieren eines Proxy-Objekts mit operator* liefert das gespeicherte Zeichen. ((nur zur Veranschaulichung)*)

Die Membertypen iterator_category, value_type, difference_type, pointer und reference müssen durch Vererbung von std::iterator<std::input_iterator_tag, CharT, typename Traits::off_type, /* nicht spezifiziert */, CharT> bezogen werden.

(bis C++17)

Der Membertyp pointer ist üblicherweise CharT* (siehe unten).

Memberfunktionen

(Konstruktor)	konstruiert einen neuen istreambuf_iterator (öffentliche Memberfunktion)
(Destruktor) (implizit deklariert)	destruiert einen istreambuf_iterator (öffentliche Memberfunktion)
operator*	holt eine Kopie des aktuellen Zeichens (öffentliche Memberfunktion)
operator++operator++(int)	bewegt den Iterator vorwärts (öffentliche Memberfunktion)
equal	prüft, ob beide istreambuf_iterators End-of-Stream sind oder ob beide gültig sind (öffentliche Memberfunktion)

Nicht-Memberfunktionen

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

vergleicht zwei istreambuf_iterators (function template)

Anmerkungen

Die Auflösung von LWG-Problem 659 führte den operator-> ein. Es wird erwartet, dass für einen std::istreambuf_iterator i die Ausdrücke (*i).m und i->m die gleiche Wirkung haben.

Die Auflösung liefert jedoch keine formale Spezifikation seines Verhaltens. Daher wird es unterschiedlich implementiert, z. B. durch Rückgabe von nullptr, Rückgabe der Adresse eines temporären Objekts oder durch gar keine Bereitstellung des Members. Sein beabsichtigtes Verhalten kann kaum erreicht werden und es wurde durch die Auflösung von LWG-Problem 2790 entfernt.

Die Auflösung von LWG-Problem 659 machte auch den Membertyp pointer nicht spezifiziert, um operator-> die Rückgabe eines Proxy zu ermöglichen. Dies dient dazu, operator-> kompilieren zu lassen, wenn CharT kein Klassentyp ist.

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <iterator>
#include <sstream>
#include <string>
 
int main()
{
    // typical use case: an input stream represented as a pair of iterators
    std::istringstream in{"Hello, world"};
    std::istreambuf_iterator<char> it{in}, end;
    std::string ss{it, end};
    std::cout << "ss has " << ss.size() << " bytes; "
                 "it holds \"" << ss << "\"\n";
 
    // demonstration of the single-pass nature
    std::istringstream s{"abc"};
    std::istreambuf_iterator<char> i1{s}, i2{s};
    std::cout << "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
 
    ++i1;
    std::cout << "after incrementing i1, but not i2:\n"
                 "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
 
    ++i2;
    std::cout << "after incrementing i2, but not i1:\n"
                 "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
}

Ausgabe

ss has 12 bytes; it holds "Hello, world"
i1 returns 'a'
i2 returns 'a'
after incrementing i1, but not i2:
i1 returns 'b'
i2 returns 'b'
after incrementing i2, but not i1:
i1 returns 'c'
i2 returns 'c'

Fehlerberichte

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

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 659	C++98	1. std::istreambuf_iterator hatte keinen operator-> 2. der Membertyp pointer war als CharT* spezifiziert	1. hinzugefügt 2. wurde nicht spezifiziert
LWG 2790	C++98	der durch LWG-Problem 659 hinzugefügte operator-> war nicht nützlich	entfernt

Siehe auch

ostreambuf_iterator	Ausgabe-Iterator, der in std::basic_streambuf schreibt (Klassenvorlage)
istream_iterator	Eingabe-Iterator, der aus std::basic_istream liest (Klassenvorlage)