std::next - cppreference.com

</tbody> <tbody class="t-dcl-rev "> </tbody><tbody>

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 además los requisitos de RandomAccessIterator, la complejidad es constante.

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

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í.

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

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.

Véase también