std::experimental::ranges::next

 

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

 

Experimentell

Technische Spezifikation

Dateisystembibliothek (Filesystem TS)

Grundlagen der Bibliothek (Library Fundamentals TS)

Grundlagen der Bibliothek 2 (Library Fundamentals TS v2)

Grundlagen der Bibliothek 3 (Library Fundamentals TS v3)

Erweiterungen für Parallelität (Parallelism TS)

Erweiterungen für Parallelität 2 (Parallelism TS v2)

Erweiterungen für Nebenläufigkeit (Concurrency TS)

Erweiterungen für Nebenläufigkeit 2 (Concurrency TS v2)

Konzepte (Concepts TS)

Bereiche (Ranges TS)

Reflektion (Reflection TS)

Mathematische Spezialfunktionen (Special Functions TR)

Experimentell Nicht-TS

Pattern Matching

Lineare Algebra

std::execution

Verträge

2D-Grafik

 

Bereiche (Ranges)

Konzepte

Allgemeine Hilfsmittel

Iteratoren

Bereiche (Ranges)

Algorithmen

 

Iterator-Bibliothek

Iterator-Konzepte
Readable Writable WeaklyIncrementable Incrementable	Iterator Sentinel SizedSentinel	InputIterator ForwardIterator BidirectionalIterator RandomAccessIterator	OutputIterator
Indirekte aufrufbare Konzepte
IndirectUnaryInvocableIndirectRegularUnaryInvocable	IndirectUnaryPredicate	IndirectRelation	IndirectStrictWeakOrder
Gemeinsame Algorithmus-Anforderungen
IndirectlyMovable IndirectlyMovableStorable	IndirectlyCopyable IndirectlyCopyableStorable	IndirectlySwappable IndirectlyComparable	Permutable Mergeable Sortable
Konzept-Dienstprogramme
indirect_result_of	projected
Iterator-Dienstprogramme und -Operationen
iter_move iter_swap	advance distance	next prev
Iterator-Traits
difference_type value_type reference_trvalue_reference_titer_common_reference_t iterator_category	input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tag	ranges::iterator_traits std::iterator_traits<InputIterator>std::iterator_traits<OutputIterator>
Iterator-Adapter
reverse_iterator move_iterator move_sentinel	back_insert_iterator front_insert_iterator insert_iterator	common_iterator counted_iterator default_sentinel	danglingborrowed_iterator_t unreachable
Stream-Iteratoren
istream_iterator	ostream_iterator	istreambuf_iterator	ostreambuf_iterator

 

Definiert in Header <experimental/ranges/iterator>
namespace {     constexpr /* nicht spezifiziert */ next = /* nicht spezifiziert */; }		(Ranges TS) (Customization-Point-Objekt)
Aufruf-Signatur
template< Iterator I > constexpr I next( I i );	(1)
template< Iterator I > constexpr I next( I i, ranges::difference_type_t<I> n );	(2)
template< Iterator I, Sentinel<I> S > constexpr I next( I i, S bound );	(3)
template< Iterator I, Sentinel<I> S > constexpr I next( I i, ranges::difference_type_t<I> n, S bound );	(4)

Fortschaltet den Iterator i n mal, oder bis bound erreicht ist, je nachdem, was zuerst eintritt, und gibt den fortgeschalteten Iterator zurück.

1) Entspricht ++i; return i;.

2) Entspricht ranges::advance(i, n); return i;.

3) Entspricht ranges::advance(i, bound); return i;.

4) Entspricht ranges::advance(i, n, bound); return i;.

Customization Point Objects

Der Name ranges::next bezeichnet ein Customization Point Object, welches ein Funktionsobjekt eines literalen Semiregular-Klassentyps ist (für Demonstrationszwecke als NextT bezeichnet). Alle Instanzen von NextT sind gleich. Daher kann ranges::next frei kopiert werden und seine Kopien können austauschbar verwendet werden.

Gegeben sei eine Menge von Typen Args.... Wenn std::declval<Args>()... die Anforderungen an Argumente für ranges::next von oben erfüllen, dann erfüllt NextT ranges::Invocable<const NextT, Args...>. Andernfalls nimmt kein Funktionsaufrufoperator von NextT an der Überladungsauflösung teil.

In jeder Translation Unit, in der ranges::next definiert ist, bezieht es sich auf dieselbe Instanz des Customization Point Objects. (Das bedeutet, dass es frei in Dingen wie Inline-Funktionen und Funktions-Templates verwendet werden kann, ohne die Ein-Definitionen-Regel zu verletzen.)

Rückgabewert

Der fortgeschaltete Iterator.

Hinweise

Obwohl das Weglassen von n für Überladung (2) so funktioniert, als wäre n gleich 1, funktioniert das Weglassen von n für Überladung (4) effektiv so, als wäre n unendlich (immer bis bound fortschalten).

Siehe auch

next (C++11)	inkrementiert einen Iterator (Funktionsvorlage)
advance	bewegt einen Iterator um die angegebene Distanz vorwärts (Funktionsvorlage)
prev	dekrementiert einen Iterator (Funktionsvorlage)
distance	gibt die Distanz zwischen einem Iterator und einem Sentinel zurück, oder zwischen dem Anfang und dem Ende eines Bereichs (Funktionsvorlage)