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

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

Fuentes