std:: iterator_traits <std::common_iterator>
From cppreference.net
<
cpp
|
iterator
|
common iterator
C++
Iterator library
| Iterator concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator primitives | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Algorithm concepts and utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Indirect callable concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Common algorithm requirements | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator adaptors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
std::common_iterator
| Member functions | ||||
| Non-member functions | ||||
|
(C++20)
|
||||
|
(C++20)
|
||||
|
(C++20)
|
||||
|
(C++20)
|
||||
| Helper classes | ||||
|
iterator_traits
<std::common_iterator>
(C++20)
|
|
定义于头文件
<iterator>
|
||
|
template
<
std::
input_iterator
I,
class
S
>
struct iterator_traits < std:: common_iterator < I, S >> ; |
(C++20 起) | |
为 std::common_iterator 类型的属性提供统一接口。
目录 |
成员类型
| 类型名称 | 定义 |
iterator_concept
|
|
iterator_category
(条件性存在) |
|
value_type
|
std:: iter_value_t < I > |
difference_type
|
std:: iter_difference_t < I > |
pointer
|
|
reference
|
std:: iter_reference_t < I > |
示例
运行此代码
#include <iterator> #include <type_traits> #include <vector> int main() { std::vector v{1, 2, 3, 4}; using CV = std::common_iterator< std::counted_iterator<std::vector<int>::iterator>, std::default_sentinel_t>; CV i{std::counted_iterator{v.begin(), 3}}; using TRCV = std::iterator_traits<decltype(i)>; static_assert(std::is_same<TRCV::iterator_concept, std::forward_iterator_tag>()); static_assert(std::is_same<TRCV::iterator_category, std::forward_iterator_tag>()); static_assert(std::is_same<TRCV::value_type, int>()); static_assert(std::is_same<TRCV::difference_type, std::vector<int>::difference_type>()); static_assert(std::is_same<TRCV::pointer, decltype(i.operator->())>()); static_assert(std::is_same<TRCV::reference, int&>()); CV s{std::default_sentinel}; using TRCS = std::iterator_traits<decltype(s)>; static_assert(std::is_same<TRCS::iterator_concept, std::forward_iterator_tag>()); static_assert(std::is_same<TRCS::iterator_category, std::forward_iterator_tag>()); static_assert(std::is_same<TRCS::value_type, int>()); static_assert(std::is_same<TRCS::difference_type, std::vector<int>::difference_type>()); static_assert(std::is_same<TRCS::pointer, decltype(s.operator->())>()); static_assert(std::is_same<TRCS::reference, int&>()); }
缺陷报告
以下行为变更缺陷报告被追溯应用于先前发布的C++标准。
| 缺陷报告 | 适用范围 | 发布时行为 | 正确行为 |
|---|---|---|---|
| LWG 3749 | C++20 |
若
std::
iter_difference_t
<
I
>
不是整数类型,
iterator_category
为
std::input_iterator_tag
|
iterator_category
在此情况下
未定义 |
参见
|
为迭代器的属性提供统一接口
(类模板) |
|
|
计算
std::common_iterator
类型的关联差值类型
(类模板特化) |