CKTIS / C++
std::advance: een iterator over een afstand verplaatsen
std::advance wijzigt een per referentie doorgegeven iterator met n posities. Er is geen grenscontrole en het resultaat is void.
Versie: C++23
Syntax
template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);std::advance uit <iterator> verandert it alsof n stappen zijn gezet. Random access kan it += n in constante tijd gebruiken; zwakkere categorieën herhalen incrementen en een bidirectionele iterator decrementeert bij negatieve n.
Gebruik dit wanneer de iterator zelf moet veranderen. Om het origineel te bewaren geeft std::next duidelijker een nieuwe iterator. De complexiteit is lineair behalve bij random access.
De functie kent geen grenzen. Vóór begin of voorbij geldig end() gaan is ongedefinieerd. Een negatieve afstand vereist een bidirectionele iterator. Controleer na containerwijzigingen ook de geldigheid.
Voorbeelden
#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';
}
Resultaat
9
std::advance → 9