Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje