CKTIS / C++
std::advance: desplazar un iterador una distancia
std::advance modifica un iterador pasado por referencia y lo desplaza n posiciones. No comprueba límites y devuelve void.
Versión: C++23
Sintaxis
template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);std::advance, de <iterator>, cambia it como tras n pasos. El acceso aleatorio permite it += n en tiempo constante; las categorías más débiles repiten incrementos y un iterador bidireccional decrementa con n negativo.
Úsala cuando deba cambiar el propio iterador. Para conservar el original, std::next devuelve otro con mayor claridad. La complejidad es lineal salvo con acceso aleatorio.
La función desconoce los límites. Ir antes del inicio o más allá del end() válido es indefinido. Una distancia negativa exige un iterador bidireccional. Tras modificar el contenedor, comprueba también que el iterador siga válido.
Ejemplos
#include <array>
#include <iostream>
#include <iterator>
int main() {
const std::array values{2, 5, 9};
auto iterator = values.begin();
std::advance(iterator, 2);
std::cout << *iterator << '\n';
}
Resultado
9
std::advance → 9