std::ranges::subrange<I,S,K>::prev
Aus de.cppreference.net
constexpr subrange prev( std::iter_difference_t<I> n = 1 ) const
requires std::bidirectional_iterator<I>;
|
(seit C++20) | |
Gibt eine Kopie von *this zurück, deren begin_ dekrementiert (oder inkrementiert, falls n negativ ist) wird. Die eigentliche Dekrementierungs- (oder Inkrementierungs-)Operation wird von advance() durchgeführt.
Äquivalent zu:auto tmp = *this;tmp.advance(-n);return tmp;.
Parameter
| n | - | Anzahl der Dekrementierungen des Iterators |
Rückgabewert
Wie oben beschrieben.
Hinweise
Der Unterschied zwischen dieser Funktion und
advance()
besteht darin, dass letztere die Dekrementierung (oder Inkrementierung) direkt durchführt.
Beispiel
Diesen Code ausführen
#include <iterator> #include <list> #include <print> #include <ranges> int main() { std::list list{1, 2, 3, 4, 5}; std::ranges::subrange sub{std::next(list.begin(), 2), std::prev(list.end(), 2)}; std::println("{} {} {}", sub, sub.prev(), sub.prev(2)); }
Ausgabe:
[3] [2, 3] [1, 2, 3]
Siehe auch
erhält eine Kopie des
subrange
mit seinem Iterator um eine gegebene Distanz vorgerückt
(öffentliche Elementfunktion) |
|
|
rückt den Iterator um eine gegebene Distanz vor
(öffentliche Elementfunktion) |
|
|
(C++11)
|
dekrementiert einen Iterator
(Funktionstemplate) |
|
(C++20)
|
dekrementiert einen Iterator um eine gegebene Distanz oder bis zu einer Grenze
(Algorithmus-Funktionsobjekt) |