std::advance

 

C++

Язык

Заголовочные файлы

Концепты

Поддержка языка

Ошибка

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод/вывод

Локализация

Регулярные выражения (C++11)

Атомарные операции (C++11)

Потоки (C++11)

Файловая система (C++17)

Технические спецификации

 

Iterator библиотеки

Iterator примитивов Оригинал: Iterator primitives Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
iterator_traits
input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tag
iterator
Iterator адаптеров Оригинал: Iterator adaptors Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
reverse_iterator
move_iterator (C++11) back_insert_iterator front_insert_iterator insert_iterator	make_move_iterator (C++11) back_inserter front_inserter inserter
Поток итераторы Оригинал: Stream iterators Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
istream_iterator
ostream_iterator
istreambuf_iterator
ostreambuf_iterator
Iterator операций Оригинал: Iterator operations Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
advance
distance
prev (C++11)
next (C++11)
Диапазон доступа Оригинал: Range access Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
begin (C++11)
end (C++11)

 

Определён в заголовочном файле <iterator>
template< class InputIt, class Distance > void advance( InputIt& it, Distance n );

Смещение итератора it на n элементов.

Если значение n отрицальное, то итератор смещается в сторону уменьшения. В этом случае InputIt должен соответствовать требованиям BidirectionalIterator, в противном случае поведение не определено.

Параметры

it	—	Итератор, чтобы быть продвинутым Оригинал: iterator to be advanced Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
n	—	Число it элементы должны быть продвинутым Оригинал: number of elements it should be advanced Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Требования к типам
- InputIt должен соответствовать требованиям InputIterator.

Возвращаемое значение

(Нет)

Сложность

Линейная.

Оригинал:

Linear.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Однако, если InputIt дополнительно соответствует требованиям RandomAccessIterator, сложность константна.

Оригинал:

However, if InputIt additionally meets the requirements of RandomAccessIterator, complexity is constant.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Пример

Запустить этот код

#include <iostream>
#include <iterator>
#include <vector>
 
int main()
{
    std::vector<int> v{ 3, 1, 4 };
 
    auto vi = v.begin();
 
    std::advance(vi, 2);
 
    std::cout << *vi << '\n';
}

Вывод:

4

См. также

distance	возвращает расстояние между двумя итераторами Оригинал: returns the distance between two iterators Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (функция)