std::next

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

[editar] Parámetros

[editar] 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.

[editar] Complejidad

Lineal.

Sin embargo, si InputIt cumple además los requisitos de RandomAccessIterator, la complejidad es constante.

[editar] Posible implementación

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;
}

[editar] Notas

Aunque la expresión ++c.begin() suele compilarse, no se garantiza que lo haga: c.begin() es una expresión r-valor y no hay ningún requisito de InputIterator que especifique que se garantiza que el incremento de un r-valor funcione. En particular, cuando los iteradores se implementan como punteros o su operator++ está calificado como referencia a l-valor, ++c.begin() no compila, mientras que std::next(c.begin()) sí.

[editar] 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

[editar] Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

[editar] Véase también