std:: next

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

Parameter

Rückgabewert

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

Komplexität

Linear.

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

Mögliche Implementierung

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

Hinweise

Obwohl der Ausdruck ++ c. begin ( ) häufig kompiliert, ist dies nicht garantiert: c. begin ( ) ist ein Rvalue-Ausdruck, und es gibt keine LegacyInputIterator -Anforderung, die festlegt, dass die Inkrementierung eines Rvalues garantiert funktioniert. Insbesondere wenn Iteratoren als Zeiger implementiert sind oder deren operator++ Lvalue-Ref-qualifiziert ist, ++ c. begin ( ) kompiliert nicht, während std :: next ( c. begin ( ) ) dies tut.

Beispiel

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

4 6
 5

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch