Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::advance: spostare un iteratore di una distanza

std::advance modifica un iteratore passato per riferimento di n posizioni. Non controlla i limiti e restituisce void.

Versione: C++23

Sintassi

template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);

std::advance di <iterator> modifica it come dopo n passi. Il random access permette it += n in tempo costante; le categorie più deboli ripetono gli incrementi e un iteratore bidirezionale decrementa con n negativo.

Usala quando deve cambiare l’iteratore stesso. Per conservare l’originale, std::next restituisce più chiaramente un nuovo iteratore. La complessità è lineare salvo il random access.

La funzione non conosce i limiti. Andare prima dell’inizio o oltre il end() valido è indefinito. Una distanza negativa richiede un iteratore bidirezionale. Dopo modifiche al contenitore controlla che l’iteratore sia ancora valido.

Esempi

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

Risultato

9

std::advance → 9

Fonti