CKTIS / C++
std::advance: posunutí iterátoru o vzdálenost
std::advance změní iterátor předaný referencí o n pozic. Nekontroluje meze a vrací void.
Verze: C++23
Syntaxe
template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);std::advance z <iterator> změní it o n kroků. Náhodný přístup dovoluje it += n v konstantním čase; slabší kategorie opakují inkrementace a obousměrný iterátor při záporném n dekrementuje.
Použij ji, když se má změnit iterátor samotný. Pro zachování originálu vrátí std::next přehledněji nový iterátor. Složitost je lineární kromě náhodného přístupu.
Funkce nezná meze. Posun před začátek nebo za platné end() je nedefinovaný. Záporná vzdálenost vyžaduje obousměrný iterátor. Po změně kontejneru ověř i platnost iterátoru.
Příklady
#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';
}
Výsledek
9
std::advance → 9