std::experimental::ranges::iterator_category

 

C++

语言

标准库

标准库头文件

自立与有宿主

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

技术规范

文件系统库 (文件系统 TS)

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行扩展 (并行 TS)

并行扩展 2 (并行 TS v2)

并发扩展 (并发 TS)

并发扩展 2 (并发 TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

数学特殊函数 (特殊函数 TR)

 

范围

概念

通用工具

迭代器

范围

算法

 

迭代器库

迭代器概念
Readable Writable WeaklyIncrementable Incrementable	Iterator Sentinel SizedSentinel	InputIterator ForwardIterator BidirectionalIterator RandomAccessIterator	OutputIterator
间接可调用概念
IndirectUnaryInvocableIndirectRegularUnaryInvocable	IndirectUnaryPredicate	IndirectRelation	IndirectStrictWeakOrder
常用算法要求
IndirectlyMovable IndirectlyMovableStorable	IndirectlyCopyable IndirectlyCopyableStorable	IndirectlySwappable IndirectlyComparable	Permutable Mergeable Sortable
概念工具
indirect_result_of	projected
迭代器工具及运算
iter_move iter_swap	advance distance	next prev
迭代器特性
difference_type value_type reference_trvalue_reference_titer_common_reference_t iterator_category	input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tag	ranges::iterator_traits std::iterator_traits<InputIterator>std::iterator_traits<OutputIterator>
迭代器适配器
reverse_iterator move_iterator move_sentinel	back_insert_iterator front_insert_iterator insert_iterator	common_iterator counted_iterator default_sentinel	danglingsafe_iterator_t unreachable
流迭代器
istream_iterator	ostream_iterator	istreambuf_iterator	ostreambuf_iterator

 

在标头 <experimental/ranges/iterator> 定义
template< class I > struct iterator_category { };	(1)
template< class T > struct iterator_category<T*>;	(2)
template< class T > struct iterator_category<const T> : iterator_category<T> { };	(3)
template <class T>   requires requires { typename T::iterator_category; } struct iterator_category<T>;	(4)

计算类 I 的迭代器类别，若它存在。用户可以对程序定义类型特化 iterator_category 。

1) 初等模板是空结构体。

2) 对指针的特化。若 T 是对象类型，则提供等于 ranges::random_access_iterator_tag 的成员类型 type 。否则，无成员 type 。

3) 对 const 限定类型的特化。

4) 对定义公开且可访问的成员类型 iterator_category 的类型的特化。若 T::iterator_category 与命名空间 std 中的迭代器类别标签之一相同或从它派生，则将它映射到描述如下的命名空间 ranges 中的对应标签。否则，提供等于 T::iterator_category 的成员类型 type 。

• 若 T::iterator_category 与 std::random_access_iterator_tag 相同或自之派生，则提供等于 ranges::random_access_iterator_tag 的成员类型 type 。
• 否则，若 T::iterator_category 与 std::bidirectional_iterator_tag 相同或自之派生，则提供等于 ranges::bidirectional_iterator_tag 的成员类型 type 。
• 否则，若 T::iterator_category 与 std::forward_iterator_tag 相同或自之派生，则提供等于 ranges::forward_iterator_tag 的成员类型 type 。
• 否则，若 T::iterator_category 与 std::input_iterator_tag 相同或自之派生，则提供等于 ranges::input_iterator_tag 的成员类型 type 。
• 否则，若 T::iterator_category 与 std::output_iterator_tag 相同或自之派生，则无成员 type 。

辅助别名模版

template< class T > using iterator_category_t = typename ranges::iterator_category<T>::type;		(范围 TS)

参阅

input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tagcontiguous_iterator_tag (C++20)	用于指示迭代器类别的空类类型 (类)
input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tag	用于指示迭代器类别的空类 (类)
iterator_traits	汇集迭代器的关联类型的兼容性特性类 (别名模板)