CKTIS / C++
std::advance: deslocar um iterador por uma distância
std::advance modifica um iterador passado por referência em n posições. Não verifica limites e devolve void.
Versão: C++23
Sintaxe
template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);std::advance, de <iterator>, altera it como após n passos. O acesso aleatório permite it += n em tempo constante; categorias mais fracas repetem incrementos e um iterador bidirecional decrementa para n negativo.
Usa-a quando o próprio iterador deve mudar. Para preservar o original, std::next devolve outro iterador de forma mais clara. A complexidade é linear fora do acesso aleatório.
A função desconhece os limites. Ir antes do início ou além do end() válido é indefinido. Uma distância negativa exige um iterador bidirecional. Após alterar o contentor, confirma também que o iterador continua válido.
Exemplos
#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