std::experimental::ranges::prev

 

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 */ prev = /* nicht spezifiziert */; }		(Ranges TS) (Customization-Point-Objekt)
Aufruf-Signatur
template< Iterator I > constexpr I prev( I i );	(1)
template< Iterator I > constexpr I prev( I i, ranges::difference_type_t<I> n );	(2)
template< Iterator I > constexpr I prev( I i, ranges::difference_type_t<I> n, I bound );	(3)

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

1) Äquivalent zu --i; return i;.

2) Äquivalent zu ranges::advance(i, -n); return i;.

3) Äquivalent zu ranges::advance(i, -n, bound); return i;.

Customization Point Objects

Der Name ranges::prev bezeichnet ein Customization Point Object, was ein Funktionsobjekt eines literalen Semiregular-Klassentyps ist (der zur Veranschaulichung als PrevT bezeichnet wird). Alle Instanzen von PrevT sind gleich. Daher kann ranges::prev frei kopiert und seine Kopien können austauschbar verwendet werden.

Gegeben eine Menge von Typen Args..., wenn std::declval<Args>()... die Anforderungen für Argumente von ranges::prev oben erfüllen, wird PrevT ranges::Invocable<const PrevT, Args...> erfüllen. Andernfalls nimmt kein Funktionsaufrufoperator von PrevT an der Überladungsauflösung teil.

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

Rückgabewert

Der dekrementierte Iterator.

Siehe auch

prev (C++11)	dekrementiert einen Iterator (Funktionsvorlage)
advance	bewegt einen Iterator um die angegebene Distanz vorwärts (Funktionsvorlage)
next	inkrementiert 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)