std::experimental::ranges::distance

 

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 /* unspecified */ distance = /* unspecified */; }		(Ranges TS) (Customization-Point-Objekt)
Aufruf-Signatur
template< Iterator I, Sentinel<I> S > constexpr ranges::difference_type_t<I> distance( I first, S last );	(1)
template< Range R > constexpr ranges::difference_type_t<ranges::iterator_t<R>> distance( R&& r );	(2)
template< SizedRange R > constexpr ranges::difference_type_t<ranges::iterator_t<R>> distance( R&& r );	(3)

Gibt die Distanz zwischen first und last zurück, oder zwischen dem Anfang und dem Ende des Bereichs r.

1) Wenn SizedSentinel<S, I> erfüllt ist, äquivalent zu return last - first;. Andernfalls wird die Anzahl der Inkremente zurückgegeben, die benötigt werden, um von first nach last zu gelangen. Wenn [first, last) keinen Bereich bezeichnet, müssen I und S denselben Typ haben und SizedSentinel modellieren, und [last, first) muss einen Bereich bezeichnen. Andernfalls ist das Verhalten undefiniert.

2) Äquivalent zu return ranges::distance(ranges::begin(r), ranges::end(r));.

3) Äquivalent zu return ranges::size(r);.

Die Instanziierung der Überladungen (2,3) kann fehlerhaft sein, wenn die Headerdatei <experimental/ranges/range> vor dem Punkt der Instanziierung eingebunden wird.

Customization Point Objects

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

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

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

Rückgabewert

Die Distanz zwischen first und last, oder zwischen dem Anfang und dem Ende des Bereichs r.

Siehe auch

distance	gibt die Distanz zwischen zwei Iteratoren zurück (Funktionsvorlage)
advance	bewegt einen Iterator um die angegebene Distanz vorwärts (Funktionsvorlage)
next	inkrementiert einen Iterator (Funktionsvorlage)
prev	dekrementiert einen Iterator (Funktionsvorlage)
size	erhält die Größe eines Bereichs, dessen Größe in konstanter Zeit berechnet werden kann (Anpassungspunkt-Objekt)