operator+(std::counted_iterator)

friend constexpr counted_iterator operator+(
    std::iter_difference_t<I> n, const counted_iterator& x )
        requires std::random_access_iterator<I>;

(since C++20)

Возвращает адаптер итератора, который сдвинут на n. Поведение неопределено, если n больше, чем длина, записанная в x (т.е. если x + n приводит к неопределённому поведению).

Эта функция не видна для обычного неквалифицированного или квалифицированного поиска и может быть найдена только с помощью поиска, зависящего от аргументов, когда std::counted_iterator<I> является ассоциированным классом аргументов.

Параметры

n	-	количество позиций для приращения итератора
x	-	адаптер итератора для приращения

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

Адаптер итератора, равный x + n.

Пример

#include <iostream>
#include <iterator>
#include <list>
#include <vector>
 
int main()
{
    std::vector v{0, 1, 2, 3, 4, 5};
    std::counted_iterator<std::vector<int>::iterator> p{v.begin() + 1, 4};
    std::cout << "*p:" << *p << ", count:" << p.count() << '\n';
    std::counted_iterator<std::vector<int>::iterator> q{2 + p};
    std::cout << "*q:" << *q << ", count:" << q.count() << '\n';
 
    std::list l{6, 7, 8, 9};
    std::counted_iterator<std::list<int>::iterator> r{l.begin(), 3};
    std::cout << "*r:" << *r << ", count:" << r.count() << '\n';
//  auto s{2 + r}; // error: the underlying iterator does
                   // not model std::random_access_iterator
}

Вывод:

*p:1, count:4
*q:3, count:2
*r:6, count:3

См. также

operator++operator++(int)operator+=operator+operator--operator--(int)operator-=operator- (C++20)	увеличивает или уменьшает итератор (публичный член-функция)
operator- (C++20)	вычисляет расстояние между двумя адаптерами итераторов (шаблон функции)
operator-(std::default_sentinel_t) (C++20)	вычисляет знаковое расстояние до конца (шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/iterator/counted_iterator/operator%2B