std::next

template< class InputIt >
InputIt next( InputIt it, typename std::iterator_traits<InputIt>::difference_type n = 1 );

template< class InputIt >
constexpr
InputIt next( InputIt it, typename std::iterator_traits<InputIt>::difference_type n = 1 );

Возвращает n-й преемник (или -n-й предшественник, если n отрицательное) итератора it.

Параметры

Возвращаемое значение

Итератор типа InputIt, содержащий n-й преемник (или -n-й предшественник, если n отрицательное) итератора it.

Сложность

Линейная.

Однако, если InputIt также удовлетворяет требованиям LegacyRandomAccessIterator, сложность — постоянная.

Возможная реализация

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

Примечания

Хотя выражение ++c.begin() часто компилируется, это не гарантируется: c.begin() — выражение типа rvalue, и нет требования LegacyInputIterator, что инкремент rvalue гарантированно работает. В частности, когда итераторы реализованы как указатели или их operator++ имеет квалификатор lvalue-ref, ++c.begin() не компилируется, в то время как std::next(c.begin()) компилируется.

Пример

#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

Отчеты об ошибках

Следующие отчеты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также