std:: next

Devuelve el n ^ésimo sucesor (o - n ^ésimo predecesor si n es negativo) del iterador it .

Parámetros

Valor de retorno

Un iterador de tipo InputIt que contiene el n ^ésimo sucesor (o - n ^ésimo predecesor si n es negativo) del iterador it .

Complejidad

Lineal.

Sin embargo, si InputIt cumple adicionalmente con los requisitos de LegacyRandomAccessIterator , la complejidad es constante.

Implementación posible

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

Notas

Aunque la expresión ++ c. begin ( ) a menudo compila, no está garantizado que lo haga: c. begin ( ) es una expresión rvalue, y no existe un LegacyInputIterator requisito que especifique que el incremento de un rvalue esté garantizado para funcionar. En particular, cuando los iteradores se implementan como punteros o su operator++ está calificado como referencia a lvalue, ++ c. begin ( ) no compila, mientras que std :: next ( c. begin ( ) ) sí lo hace.

Ejemplo

#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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

Véase también