C++ 具名要求：容器 (Container)

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

C++ 具名要求

基础
DefaultConstructible CopyAssignable CopyConstructible	MoveAssignable (C++11) MoveConstructible (C++11) Destructible
类型属性
TrivialType (C++11) TriviallyCopyable (C++11)	StandardLayoutType (C++11) PODType
库所属
EqualityComparable LessThanComparable Swappable (C++11) ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11)	Allocator FunctionObject Callable Predicate BinaryPredicate Compare
容器
Container SequenceContainer ContiguousContainer (C++17) ReversibleContainer	AssociativeContainer AllocatorAwareContainer UnorderedAssociativeContainer (C++11)
容器元素
DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11)	EmplaceConstructible (C++11) Erasable (C++11)
迭代器
LegacyIterator LegacyOutputIterator LegacyInputIterator LegacyForwardIterator	LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20)
流 I/O
FormattedInputFunction UnformattedInputFunction	FormattedOutputFunction UnformattedOutputFunction
随机数
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)
其他
CharTraits RegexTraits (C++11) BitmaskType NumericType LiteralType (C++11)	UnaryTypeTrait (C++11) BinaryTypeTrait (C++11) TransformationTrait (C++11) Clock (C++11) TrivialClock (C++11)

 

容器 (Container) 是用于存储其他对象并照顾管理其所容纳的对象所用的内存的对象。

要求

• 容器类型 C；
• 元素类型 T；
• C 类型的对象 a、b。
• rv ， C 类型右值表达式。

类型

名称	类型	注解
value_type	T	可擦除 (Erasable)
reference	T&
const_reference	const T&
iterator	指向 T 的迭代器	老式向前迭代器 (LegacyForwardIterator) 可转换为 const_iterator
const_iterator	指向 T 的常迭代器	老式向前迭代器 (LegacyForwardIterator)
difference_type	有符号整数	必须与 iterator 和 const_iterator 的 iterator_traits::difference_type 相同
size_type	无符号整数	足够大以表示 difference_type 的所有正值

方法与运算符

表达式	返回类型	语义	条件	复杂度
C()	C	创建空容器	后：C().empty() == true	常数
C(a)	C	创建 a 的副本	前：T 必须为可复制插入 (CopyInsertable) 后：a == C(a)	线性
C(rv)(C++11 起)	C	移动 rv	后：等于 rv 在此构造前的值	常数
a = b	C&	销毁或从 b 的元素复制赋值 a 的所有元素	后：a == b	线性
a = rv	C&	销毁或从 rv 的元素移动赋值 a 的所有元素	后：若 a 与 rv 不指代同一对象则 a 等于 rv 在此赋值前拥有的值	线性
a.~C()	void	销毁 a 的所有元素并释放所有内存		线性
a.begin()	(const_)iterator	指向 a 首元素的迭代器		常数
a.end()	(const_)iterator	指向 a 尾元素后一位的元素		常数
a.cbegin()(C++11 起)	const_iterator	const_cast<const C&>(a).begin()		常数
a.cend()(C++11 起)	const_iterator	const_cast<const C&>(a).end()		常数
a == b	可转换为 bool	a.size() == b.size() && std::equal(a.begin(), a.end(), b.begin()) (C++14 前)std::equal(a.begin(), a.end(), b.begin(), b.end()) (C++14 起)	前：T 必须可相等比较 (EqualityComparable)	若 a.size() != b.size() 则为常数，否则为线性
a != b	可转换为 bool	!(a == b)		线性
a.swap(b)	void	交换 a 与 b 的值		常数
swap(a, b)	void	a.swap(b)		常数
a.size()	size_type	std::distance(a.begin(), a.end())		常数
a.max_size()	size_type	b.size() ，其中 b 是最大的可能容器		常数
a.empty()	可转换为 bool	a.begin() == a.end()		常数
注

给定

• 容器的 iterator 类型的对象 i 与 j，

表达式 i == j、i != j、i < j、i <= j、i >= j、i > j、i - j 中，任一或二者都可以用指代相同元素的一个该容器的 const_iterator 类型的对象替换，而不更改其语义。

容器数据竞争

见容器线程安全

其他要求

C

• 可默认构造 (DefaultConstructible)
• 可复制构造 (CopyConstructible)
• 可相等比较 (EqualityComparable)
• 可交换 (Swappable)

T

• 可复制插入 (CopyInsertable)
• 可相等比较 (EqualityComparable)
• 可析构 (Destructible)

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR	应用于	出版时的行为	正确行为
LWG 179	C++98	iterator 与 const_iterator 类型可能不可比较	要求可比较
LWG 2263	C++11	LWG179 的解决方案在 C++11 中被意外丢弃	已恢复
LWG 2839	C++11	不允许标准容器的自移动赋值	容许但结果未指定