C++ 具名要求：关联容器 (AssociativeContainer)
来自cppreference.com
关联容器 (AssociativeContainer) 是提供基于键的快速对象查找的容器 (Container) 。
要求
凡例 | |
X
|
容器类型 |
a
|
X 类型的值
|
a2
|
其结点句柄与 X 兼容的 Y 类型的值
|
b
|
X 类型的可能为 const 的值
|
u
|
任意变量名 |
a_uniq
|
（当 X 支持唯一键时）X 类型的值
|
a_eq
|
（当 X 支持多重键时）X 类型的值
|
a_tran
|
（当 X::key_compare::is_transparent 存在时）X 类型的可能为 const 的值
|
i, j
|
遗留输入迭代器 (LegacyInputIterator) ，指代有效范围并指向可隐式转换到 X::value_type 的元素
|
p
|
指向 a 的有效常迭代器
|
q
|
指向 a 的有效可解引用常量迭代器
|
r
|
指向 a 的可解引用迭代器
|
q1, q2
|
指代 a 中的有效范围的常迭代器
|
il
|
std::initializer_list<X::value_type> 类型的对象 |
t
|
X::value_type 类型的值
|
k
|
X::key_type 类型的值
|
c
|
X::key_compare 类型的可以为 const 的值
|
kl
|
一个值，使得 a 依据 c(r,kl) 已划分，其中 r 是 e 的键且 e 在 a 中
|
ku
|
一个值，使得 a 依据 !c(ku, r) 已划分
|
ke
|
一个值，使得 a 依据 c(r, ke) 与 !c(ke, r) 已划分，其中 c(r, ke) 隐含 !c(ke, r)
|
A
|
X 所用的存储分配器，或 std::allocator_type<X::value_type>
|
m
|
分配器，其类型可转换为 A
|
nh
|
X::node_type 类型的非 const 右值
|
| 表达式 | 返回类型 | 前条件/要求 | 后条件/效果 | 复杂度 |
|---|---|---|---|---|
| X::key_type | Key |
Key 可析构 (Destructible) |
编译时 | |
| X::key_compare | Compare |
编译时 | ||
| X::value_compare | 满足二元谓词 (BinaryPredicate) 的类型 | 对于 std::set 和 std::multiset 为 key_compare； 对于 std::map 和 std::multimap 为 Key 上的顺序关系 |
编译时 | |
| X(c), X a(c); | key_compare 可复制构造 (CopyConstructible) | 以 c 的副本为 key_comp 构造空容器 |
常数 | |
| X(), X a; | key_compare 可复制构造 (CopyConstructible) | 以 Compare() 为 key_comp 构造空容器 |
常数 | |
| X(i, j, c), X a(i, j, c); | key_compare 可复制构造 (CopyConstructible) 且 value_type 从 *i 可就位构造 (EmplaceConstructible) 到 X | 以 c 的副本为 key_comp 构造空容器并插入来自范围 [i; j) 的所有元素 |
通常为 N log N，或若 [i, j) 已排序则为 N（其中 N 是 std::distance(i, j)）
| |
| X(i, j), X a(i, j); | key_compare 可复制构造 (CopyConstructible) 且 value_type 从 *i 可就位构造 (EmplaceConstructible) 到 X | 以 Compare() 为 key_comp 构造空容器并插入来自范围 [i; j) 的所有元素 |
通常为 N log N，或若 [i, j) 已按照 value_comp() 排序则为 N（其中 N 是 std::distance(i, j)）
| |
| X(il); | 等价于 X(il.begin(), il.end()); | 等价于 X(il.begin(), il.end()); | ||
| a = il | X& | T 可复制插入 (CopyInsertable) 到 X 而且亦可复制赋值 (CopyAssignable) |
将范围 [il.begin(), il.end()) 赋值到 a。 a 的未被赋值元素均被销毁 |
通常为 N log N，或若 [il.begin(), il.end()) 已按照 value_comp() 排序则为 N（其中 N 是 il.size() + a.size()）
|
| a.key_comp() | X::key_compare | 返回构造 a 所用的比较对象。 |
常数 | |
| a.value_comp() | X::value_compare | 返回在比较对象外构造的 X::value_compare 类型的对象。 | 常数 |
作为 std::map 或 std::multimap 的关联容器 X 额外支持表达式 X::mapped_type，它以 T 为返回的类型（但要求 T 可析构 (Destructible) ），及编译时复杂度。
| 本节未完成 原因：完成要求。 |
标准库中的关联容器
| 唯一键的集合，按照键排序 (类模板) | |
| 键的集合，按照键排序 (类模板) | |
| 键值对的集合，按照键排序，键是唯一的 (类模板) | |
| 键值对的集合，按照键排序 (类模板) |
