Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::next — una copia avanzada de un iterador

std::next, de <iterator>, devuelve una copia de un iterador avanzada n posiciones; por defecto, una. También admite iteradores sin operator +. No comprueba los límites del rango; un desplazamiento negativo requiere un iterador bidireccional.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <iterator>

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

std::next(x, n) recibe un iterador por valor, realiza el equivalente de std::advance(x, n) y devuelve el resultado. Si se omite n, se usa 1. A diferencia de std::advance, no asigna la nueva posición a la variable iteradora proporcionada.

Funciona con iteradores de entrada que cumplen los requisitos de Cpp17InputIterator. Un valor negativo de n requiere un iterador bidireccional. El coste es O(1) para iteradores de acceso aleatorio y O(|n|) en los demás casos. Por ejemplo, un iterador de std::list no admite +, pero se puede avanzar con std::next.

La función no recibe ningún límite del rango ni lo comprueba. No se debe mover el iterador más allá de las posiciones permitidas. El resultado puede ser igual a end(), pero en ese caso no se debe desreferenciar. Copiar un iterador de entrada de una sola pasada no garantiza una lectura independiente: avanzar la copia puede consumir una entrada compartida e invalidar copias anteriores.

No confundas std::next con std::ranges::next: esta última también ofrece sobrecargas con centinela, incluida std::ranges::next(x, n, bound), que detiene el avance en el límite. El ejemplo siguiente usa iteradores bidireccionales: first permanece en 10, third apunta a 30 y retroceder desde end() da 40.

Ejemplos

#include <iostream>
#include <iterator>
#include <list>

int main() {
    const std::list<int> values{10, 20, 30, 40};
    auto first = values.begin();
    auto third = std::next(first, 2);
    auto last = std::next(values.end(), -1);

    std::cout << *first << ' ' << *third << ' ' << *last << '\n';
}

Resultado

10 30 40

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes