C++ 命名要求： LegacyContiguousIterator (自 C++17 起)

 

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)

 

一个 LegacyContiguousIterator 是一个 LegacyIterator，其逻辑上相邻的元素在内存中也是物理上相邻的。

指向数组元素的指针满足 LegacyContiguousIterator 的所有要求。

要求

类型 It 满足 LegacyContiguousIterator，如果

• 类型 It 满足 LegacyIterator

并且，对于每个

• a，一个可解引用的类型为 It 的迭代器
• n，一个整数值

使得

• a + n 是一个有效且可解引用的迭代器值

那么

• *(a + n) 等价于 *(std::addressof(*a) + n).

标准库

以下标准库类型是 LegacyContiguousIterators。

• array::iterator.
• basic_string_view::iterator.
• basic_string::iterator.
• vector::iterator 对于除 bool 以外的 value_type。
• begin(valarray) 和 end(valarray) 的返回值类型。

注释

指向对象类型的 奇特指针 也需要满足 LegacyContiguousIterator。

LegacyContiguousIterator 被 contiguous_iterator 概念所取代：在 C++17 中需要满足 LegacyContiguousIterator 的标准库中的迭代器类型在 C++20 中需要模拟 contiguous_iterator。

(自 C++20 起)

参见

contiguous_iterator (C++20)	指定 random_access_iterator 是一个连续迭代器，指的是内存中连续的元素 (概念)
迭代器库	提供迭代器、迭代器特征、适配器和实用程序函数的定义