CKTIS / C++
std::advance: преместване на итератор с разстояние
std::advance променя итератор, подаден по референция, с n позиции. Не проверява граници и връща void.
Версия: C++23
Синтаксис
template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);std::advance от <iterator> променя it с n стъпки. Произволният достъп позволява it += n за константно време; по-слабите категории повтарят увеличения, а двупосочният итератор намалява при отрицателно n.
Използвай я, когато самият итератор трябва да се промени. За запазване на оригинала std::next по-ясно връща нов итератор. Сложността е линейна освен при произволен достъп.
Функцията не знае границите. Преместване преди началото или след валидно end() е неопределено. Отрицателно разстояние изисква двупосочен итератор. След промяна на контейнера провери валидността.
Примери
#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';
}
Резултат
9
std::advance → 9