Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::advance: premik iteratorja za razdaljo

std::advance spremeni iterator, podan po referenci, za n položajev. Ne preverja meja in vrne void.

Različica: C++23

Sintaksa

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

std::advance iz <iterator> spremeni it za n korakov. Naključni dostop omogoča it += n v konstantnem času; šibkejše kategorije ponavljajo prirastke, dvosmerni iterator pa pri negativnem n zmanjšuje.

Uporabi jo, ko se mora spremeniti iterator sam. Za ohranitev izvirnika std::next jasneje vrne nov iterator. Zahtevnost je linearna razen pri naključnem dostopu.

Funkcija ne pozna meja. Premik pred začetek ali čez veljavni end() je nedefiniran. Negativna razdalja zahteva dvosmerni iterator. Po spremembi vsebnika preveri tudi veljavnost iteratorja.

Primeri

#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';
}

Rezultat

9

std::advance → 9

Viri