std:: iter_move (std::reverse_iterator)
| Iterator concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator primitives | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Algorithm concepts and utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Indirect callable concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Common algorithm requirements | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator adaptors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
| Non-member functions | ||||
|
iter_move
(C++20)
|
||||
|
(C++20)
|
||||
|
(C++14)
|
|
friend
constexpr
std::
iter_rvalue_reference_t
<
Iter
>
iter_move ( const std:: reverse_iterator & i ) noexcept ( /* siehe unten */ ) ; |
(seit C++20) | |
Wandelt das Ergebnis der Dereferenzierung des angepassten zugrundeliegenden Iterators in seinen zugehörigen Rvalue-Referenztyp um.
Entspricht
auto
tmp
=
i.
base
(
)
;
return
std
::
ranges::
iter_move
(
--
tmp
)
;
.
Diese Funktionsvorlage ist für gewöhnliches unqualified oder qualified lookup nicht sichtbar und kann nur durch argument-dependent lookup gefunden werden, wenn std:: reverse_iterator < Iter > eine assoziierte Klasse der Argumente ist.
Inhaltsverzeichnis |
Parameter
| i | - | ein Source Reverse Iterator |
Rückgabewert
Ein Rvalue-Referenz oder ein Prvalue-Temporärobjekt.
Komplexität
Konstante.
Exceptions
std::
is_nothrow_copy_constructible_v
<
Iter
>
&&
noexcept
(
std
::
ranges::
iter_move
(
--
std::
declval
<
Iter
&
>
(
)
)
)
Beispiel
#include <iomanip> #include <iostream> #include <iterator> #include <string> #include <vector> void print(const auto& rem, const auto& v) { std::cout << rem << '[' << size(v) << "] {"; for (char comma[]{0, 0}; const auto& s : v) std::cout << comma << ' ' << std::quoted(s), comma[0] = ','; std::cout << " }\n"; } int main() { std::vector<std::string> p{"Alpha", "Bravo", "Charlie"}, q; print("p", p), print("q", q); using RI = std::reverse_iterator<std::vector<std::string>::iterator>; for (RI iter{p.rbegin()}, rend{p.rend()}; iter != rend; ++iter) q.emplace_back(/* ADL */ iter_move(iter)); print("p", p), print("q", q); }
Mögliche Ausgabe:
p[3] { "Alpha", "Bravo", "Charlie" }
q[0] { }
p[3] { "", "", "" }
q[3] { "Charlie", "Bravo", "Alpha" }
Siehe auch
|
(C++20)
|
wandelt das Ergebnis der Dereferenzierung eines Objekts in seinen zugehörigen Rvalue-Referenztyp um
(Customization Point Object) |
|
(C++20)
|
wandelt das Ergebnis der Dereferenzierung des zugrundeliegenden Iterators in seinen zugehörigen Rvalue-Referenztyp um
(Funktion) |
|
(C++11)
|
konvertiert das Argument zu einem Xvalue
(Funktionstemplate) |
|
(C++11)
|
konvertiert das Argument zu einem Xvalue, wenn der Move-Konstruktor keine Ausnahme wirft
(Funktionstemplate) |
|
(C++11)
|
leitet ein Funktionsargument weiter und verwendet den Typ-Template-Parameter, um seine Wertkategorie zu erhalten
(Funktionstemplate) |
|
(C++20)
|
verschiebt einen Elementbereich an einen neuen Speicherort
(Algorithmus-Funktionsobjekt) |
|
(C++20)
|
verschiebt einen Elementbereich in umgekehrter Reihenfolge an einen neuen Speicherort
(Algorithmus-Funktionsobjekt) |