std::ranges::iter_move

 

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)

 

Definiert in Header <iterator>
inline namespace /* nicht spezifiziert */ {     inline constexpr /* nicht spezifiziert */ iter_move = /* nicht spezifiziert */; }		(seit C++20) (Customization-Point-Objekt)
Aufruf-Signatur
template< class T >     requires /* siehe unten */ constexpr decltype(auto) iter_move( T&& t ) noexcept(/* siehe unten */);		(seit C++20)

Holt eine rvalue-Referenz oder ein prvalue-Temporäres von einem gegebenen Iterator.

Ein ranges::iter_move(t) ist ausdrucks-äquivalent zu

1. iter_move(t), wenn t einen Klassen- oder Aufzählungstyp hat und der Ausdruck gut geformt ist, wenn er als nicht ausgewerteter Operand behandelt wird, wobei die Überladungsauflösung von iter_move nur mit den Kandidaten durchgeführt wird, die durch argumentabhängige Suche gefunden werden.
2. Andernfalls std::move(*t), wenn *t gut geformt ist und ein lvalue ist.
3. Andernfalls *t, wenn *t gut geformt ist und ein rvalue ist.

In allen anderen Fällen ist ein Aufruf von ranges::iter_move schlecht geformt, was zu einem Substitutionsfehler führen kann, wenn ranges::iter_move(e) im unmittelbaren Kontext einer Vorlageninstanziierung erscheint.

Wenn ranges::iter_move(e) nicht gleich *e ist, ist das Programm schlecht geformt, keine Diagnose erforderlich.

Customization Point Objects

Der Name ranges::iter_move bezeichnet ein Customization Point Object, das ein konstanter Funktionsobjekt vom Typ Literal semiregular ist. Zu Auslegungszwecken wird die cv-unqualifizierte Version seines Typs als __iter_move_fn bezeichnet.

Alle Instanzen von __iter_move_fn sind gleich. Die Auswirkungen des Aufrufs verschiedener Instanzen vom Typ __iter_move_fn auf dieselben Argumente sind äquivalent, unabhängig davon, ob der Ausdruck, der die Instanz bezeichnet, ein lvalue oder ein rvalue ist und ob er mit const qualifiziert ist oder nicht (eine volatile-qualifizierte Instanz muss jedoch nicht aufrufbar sein). Daher kann ranges::iter_move frei kopiert werden und seine Kopien können austauschbar verwendet werden.

Gegeben einer Menge von Typen Args..., wenn std::declval<Args>()... die Anforderungen für Argumente an ranges::iter_move oben erfüllt, modelliert __iter_move_fn

• std::invocable<__iter_move_fn, Args...>,
• std::invocable<const __iter_move_fn, Args...>,
• std::invocable<__iter_move_fn&, Args...>, und
• std::invocable<const __iter_move_fn&, Args...>.
  

Andernfalls nimmt kein Funktionsaufrufoperator von __iter_move_fn an der Überladungsauflösung teil.

Siehe auch

iter_move (C++20)	konvertiert das Ergebnis der Dereferenzierung des angepassten zugrunde liegenden Iterators in seinen zugehörigen rvalue-Referenztyp (Funktion)
iter_move (C++20)	castet das Ergebnis der Dereferenzierung des zugrundeliegenden Iterators in seinen zugehörigen rvalue-Referenztyp (Funktion)