CKTIS / C++
std::advance: pomicanje iteratora za udaljenost
std::advance mijenja iterator predan referencom za n položaja. Ne provjerava granice i vraća void.
Verzija: C++23
Sintaksa
template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);std::advance iz <iterator> mijenja it za n koraka. Slučajni pristup dopušta it += n u konstantnom vremenu; slabije kategorije ponavljaju povećanja, a dvosmjerni iterator pri negativnom n smanjuje.
Koristi je kada se mora promijeniti sam iterator. Za očuvanje izvornika std::next jasnije vraća novi iterator. Složenost je linearna osim kod slučajnog pristupa.
Funkcija ne poznaje granice. Pomak prije početka ili iza valjanog end() je nedefiniran. Negativna udaljenost zahtijeva dvosmjerni iterator. Nakon promjene spremnika provjeri i valjanost iteratora.
Primjeri
#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