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