Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::advance: posunutie iterátora o vzdialenosť

std::advance zmení iterátor odovzdaný referenciou o n pozícií. Nekontroluje hranice a vracia void.

Verzia: C++23

Syntax

template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);

std::advance z <iterator> zmení it o n krokov. Náhodný prístup dovoľuje it += n v konštantnom čase; slabšie kategórie opakujú inkrementácie a obojsmerný iterátor pri zápornom n dekrementuje.

Použi ju, keď sa má zmeniť samotný iterátor. Na zachovanie originálu vráti std::next prehľadnejšie nový iterátor. Zložitosť je lineárna okrem náhodného prístupu.

Funkcia nepozná hranice. Posun pred začiatok alebo za platné end() je nedefinovaný. Záporná vzdialenosť vyžaduje obojsmerný iterátor. Po zmene kontajnera over aj platnosť iterátora.

Prí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ýsledok

9

std::advance → 9

Zdroje