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