База знанияИзпитен център
BGБългарски
Избери език13

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

Източници