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.