std::experimental::ranges::dangling, std::experimental::ranges::safe_iterator_t

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (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 <ranges::CopyConstructible T> class dangling { public:     dangling() requires ranges::DefaultConstructible<T>();     dangling(T t);     T get_unsafe() const; };		(范围 TS)
template<ranges::Range R> using safe_iterator_t = std::conditional_t<std::is_lvalue_reference<R>::value,                                            ranges::iterator_t<R>,                                            ranges::dangling<ranges::iterator_t<R>>;		(范围 TS)

类模板 dangling 是围绕对象的简单包装器，指示被包装对象可以悬垂，即它指代生存期可以已经结束的另一对象。

若范围为右值范围，则别名模版 safe_iterator_t 返回包装于 dangling 中的 R 类型迭代器（以非左值引用类型的 R 指示）。

接受左值范围并返回指向其中的迭代器范围算法使用它们。

成员函数

std::experimental::ranges::dangling::dangling

dangling() requires ranges::DefaultConstructible<T>();	(1)
dangling(T t);	(2)

1) 默认构造函数。值初始化被包装对象。

2) 以 t 初始化被包装对象。注意此构造函数定义从 T 到 dangling<T> 的隐式转换。

std::experimental::ranges::dangling::get_unsafe

T get_unsafe() const;

返回被包装对象的副本。