Namespaces
Variants

std:: prev

From cppreference.net
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
Definiert im Header <iterator>
template < class BidirIt >
BidirIt prev ( BidirIt it, typename std:: iterator_traits < BidirIt > :: difference_type n = 1 ) ;
(seit C++11)
(bis C++17)
template < class BidirIt >

constexpr

BidirIt prev ( BidirIt it, typename std:: iterator_traits < BidirIt > :: difference_type n = 1 ) ;
(seit C++17)

Gib den n ten Vorgänger (oder - n ten Nachfolger, falls n negativ ist) des Iterators it zurück.

Inhaltsverzeichnis

Parameter

it - ein Iterator
n - Anzahl der Elemente, it sollte abgestiegen werden
Typanforderungen
-
BidirIt muss die Anforderungen von LegacyBidirectionalIterator erfüllen.

Rückgabewert

Ein Iterator vom Typ BidirIt , der den n ten Vorgänger (oder - n ten Nachfolger, falls n negativ ist) des Iterators it enthält.

Komplexität

Linear.

Wenn jedoch BidirIt zusätzlich die Anforderungen von LegacyRandomAccessIterator erfüllt, ist die Komplexität konstant.

Mögliche Implementierung

template<class BidirIt>
constexpr // seit C++17
BidirIt prev(BidirIt it, typename std::iterator_traits<BidirIt>::difference_type n = 1)
{
    std::advance(it, -n);
    return it;
}

Hinweise

Obwohl der Ausdruck -- c. end ( ) oft kompiliert, ist dies nicht garantiert: c. end ( ) ist ein Rvalue-Ausdruck, und es gibt keine Iterator-Anforderung, die spezifiziert, dass die Dekrementierung eines Rvalues garantiert funktioniert. Insbesondere wenn Iteratoren als Zeiger implementiert sind oder deren operator -- Lvalue-Ref-qualifiziert ist, -- c. end ( ) kompiliert nicht, während std :: prev ( c. end ( ) ) dies tut.

Beispiel

#include <iostream>
#include <iterator>
#include <vector>
int main()
{
    std::vector<int> v{3, 1, 4};
    auto it = v.end();
    auto pv = std::prev(it, 2);
    std::cout << *pv << '\n';
    it = v.begin();
    pv = std::prev(it, -2);
    std::cout << *pv << '\n';
}

Ausgabe:

1
4

Siehe auch

(C++11)
erhöht einen Iterator
(Funktions-Template)
bewegt einen Iterator um eine gegebene Distanz
(Funktions-Template)
gibt die Distanz zwischen zwei Iteratoren zurück
(Funktions-Template)
verringert einen Iterator um eine gegebene Distanz oder bis zu einer Grenze
(Algorithmus-Funktionsobjekt)