operator+(std::counted_iterator)

来自cppreference.com
 
 
迭代器库
迭代器概念
迭代器原语
算法概念与工具
间接可调用概念
常用算法要求
工具
迭代器适配器
流迭代器
迭代器定制点
迭代器操作
(C++11)
(C++11)
范围访问
(C++11)(C++14)
(C++11)(C++14)
(C++17)(C++20)
(C++14)(C++14)
(C++14)(C++14)
(C++17)
(C++17)
 
 
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

参阅

推进或回退迭代器
(公开成员函数)
(C++20)
计算两个迭代器适配器间的距离
(函数模板)
计算到末尾的有符号距离
(函数模板)