C++ 命名需求： LegacyBidirectionalIterator

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

C++ 命名需求

基本 DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible 类型属性 ScalarType PODType TriviallyCopyable (C++11) TrivialType (C++11) StandardLayoutType (C++11)   ImplicitLifetimeType 库范围 BooleanTestable EqualityComparable LessThanComparable Swappable ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11) Allocator FunctionObject Callable Predicate BinaryPredicate Compare

Container Container ReversibleContainer AllocatorAwareContainer SequenceContainer ContiguousContainer (C++17) AssociativeContainer UnorderedAssociativeContainer (C++11)   容器元素 DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11) EmplaceConstructible (C++11) Erasable (C++11) Iterator LegacyIterator LegacyInputIterator LegacyOutputIterator LegacyForwardIterator LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20) 流 I/O FormattedInputFunction UnformattedInputFunction FormattedOutputFunction UnformattedOutputFunction 格式化程序 BasicFormatter (C++20) Formatter (C++20)

随机数 SeedSequence (C++11) RandomNumberEngine (C++11) RandomNumberDistribution (C++11) UniformRandomBitGenerator (C++11) RandomNumberEngineAdaptor (C++11) 并发 BasicLockable (C++11) Lockable (C++11) TimedLockable (C++11) SharedLockable (C++14) SharedTimedLockable (C++14) Mutex (C++11) TimedMutex (C++11) SharedMutex (C++17) SharedTimedMutex (C++14) 范围 RangeAdaptorObject (C++20) RangeAdaptorClosureObject (C++20) 多维视图 LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) 其他 CharTraits RegexTraits (C++11)   BitmaskType LiteralType (C++11) NumericType UnaryTypeTrait (C++11) BinaryTypeTrait (C++11) TransformationTrait (C++11) Clock (C++11) TrivialClock (C++11)

 

一个 LegacyBidirectionalIterator 是一个 LegacyForwardIterator，它可以双向移动（即增加和减少）。

如果一个 LegacyBidirectionalIterator it 来自一个 Container，那么 it 的 value_type 与容器相同，所以解引用 (*it) 获得容器的 value_type。

需求

类型 It 满足 LegacyBidirectionalIterator 如果

• 类型 It 满足 LegacyForwardIterator

并且，假设

• a 和 b 是 It 类型的左值
• reference，由 std::iterator_traits<It>::reference 表示的类型

以下表达式必须有效并且具有指定的含义

表达式	返回值	等效表达式	注释
--a	It&		前提条件 a 是可递减的（存在这样的 b 使得 a == ++b) 后置条件 a 是 可解引用的 --(++a) == a 如果 --a == --b 那么 a == b a 和 --a 指向相同的迭代器对象
a--	可转换为 const It&	It temp = a; --a; return temp;
*a--	reference

一个 可变 LegacyBidirectionalIterator 是一个 LegacyBidirectionalIterator，它还满足 LegacyOutputIterator 需求。

注释

开始迭代器不可递减，如果 --container.begin() 被求值，则行为未定义。

双向迭代器不必可解引用才能递减（特别是，结束迭代器不可解引用，但可以递减）。

概念 对于 std::iterator_traits 的定义，定义了以下仅供说明的概念。 template<class I> concept __LegacyBidirectionalIterator =     __LegacyForwardIterator<I> && requires(I i)     {         {  --i } -> std::same_as<I&>;         {  i-- } -> std::convertible_to<const I&>;         { *i-- } -> std::same_as<std::iter_reference_t<I>>;     }; 其中，仅供说明的概念 __LegacyForwardIterator 在 LegacyForwardIterator 中有描述。

(自 C++20)

缺陷报告

以下行为更改的缺陷报告被追溯地应用于先前发布的 C++ 标准。

DR	应用于	发布的行为	正确行为
LWG 299 (N3066)	C++98	*a-- 的返回值类型 要求可以转换为 T	更改返回值 类型为 reference
LWG 383	C++98	b 要求在 --a 之后可解引用	a 要求可解引用，而不是
LWG 1212 (N3066)	C++98	*a-- 的返回值类型与 *a++ 的返回值类型不匹配，这是 LegacyForwardIterator 所要求的	更改返回值 类型为 reference

参见

bidirectional_iterator (C++20)	指定 forward_iterator 是一个双向迭代器，支持向后移动 (概念)
迭代器库	提供迭代器、迭代器特性、适配器和实用函数的定义