# operator+(std::counted_iterator)

< cpp‎ | iterator‎ | counted iterator

friend constexpr counted_iterator operator+( std::iter_difference_t<I> n, const counted_iterator& x ) requires std::random_access_iterator<I>; |  | (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 }; // 错误：底层迭代器不实现 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) | 计算到末尾的有符号距离 (函数模板)