User avatar admin

Translation uploaded
so as to not exceed the maximum load factor. + Because the maximum load factor is defined as the number of elements divided by the total number of available buckets, this function is logically equivalent to: + ``` x.rehash(std::ceil(n / x.max_load_factor())) ``` + See the xref:reference/unordered_map.adoc#unordered_map_rehash[reference for more details] on the `rehash` function.
so as to not exceed the maximum load factor. + Because the maximum load factor is defined as the number of elements divided by the total number of available buckets, this function is logically equivalent to: + ``` 以确保不超过最大负载因子。由于最大负载因子定义为元素数量除以可用桶的总数，该函数在逻辑上等价于：
```cppx.rehash(std::ceil(n / x.max_load_factor())) ``` + See the
有关 `rehash` 函数的更多详细信息，请参阅 xref:reference/unordered_map.adoc#unordered_map_rehash[reference for more details] on the `rehash` function.参考文档]。
06/05/2026
User avatar admin

Translation uploaded
`reserve(n)` reserves space for at least `n` elements, allocating enough buckets
`reserve(n)` reserves space for at least `n` elements, allocating enough buckets为至少 `n` 个元素预留空间，分配足够数量的桶，
06/05/2026
User avatar admin

Translation uploaded
``` x.reserve(n); ```
``` x.reserve(n); ```
06/05/2026
User avatar admin

Translation uploaded
In a similar manner to using `reserve` for ``vector``s, it can be a good idea to call `reserve` before inserting a large number of elements. This will get the expensive rehashing out of the way and let you store iterators, safe in the knowledge that they won't be invalidated. If you are inserting `n` elements into container `x`, you could first call:
In a similar manner to using `reserve` for ``vector``s, it can be a good idea to call `reserve` before inserting a large number of elements. This will get the expensive rehashing out of the way and let you store iterators, safe in the knowledge that they won't be invalidated. If you are inserting `n` elements into container `x`, you could first call:与为 `vector` 使用 `reserve` 类似，在插入大量元素之前调用 `reserve` 是一个好主意。这样可以避免代价高昂的重哈希操作，并且让你能够存储迭代器，确信它们不会被失效。如果你要向容器 `x` 插入 `n` 个元素，可以先调用：
06/05/2026
User avatar admin

Translation uploaded
As for pointers and references, they are never invalidated for node-based containers (`boost::unordered_[multi]set`, `boost::unordered_[multi]map`, `boost::unordered_node_set`, `boost::unordered_node_map`), but they will be when rehashing occurs for `boost::unordered_flat_set` and `boost::unordered_flat_map`: this is because these containers store elements directly into their holding buckets, so when allocating a new bucket array the elements must be transferred by means of move construction.
As for pointers and references, they are never invalidated for node-based containers (对于基于节点的容器（ `boost::unordered_[multi]++_[++multi++]++set`, 、 `boost::unordered_[multi]++_[++multi++]++map`, 、 `boost::unordered_node_++_++node++_++set`, 、 `boost::unordered_node_map`), but they will be when rehashing occurs for++_++node++_++map` ），其指针和引用永远不会失效。但对于 `boost::unordered_flat_++_++flat++_++set` and和 `boost::unordered_flat_map`: this is because these containers store elements directly into their holding buckets, so when allocating a new bucket array the elements must be transferred by means of move construction.++_++flat++_++map` ，在发生重哈希时指针和引用将会失效：这是因为这些容器将元素直接存储在桶中，当分配新的桶数组时，必须通过移动构造来转移元素。
06/05/2026
User avatar admin

Translation uploaded
It is not specified how member functions other than `rehash` and `reserve` affect the bucket count, although `insert` can only invalidate iterators when the insertion causes the container's load to be greater than the maximum allowed. For most implementations this means that `insert` will only change the number of buckets when this happens. Iterators can be invalidated by calls to `insert`, `rehash` and `reserve`.
It is not specified how member functions other than标准未明确规定除 `rehash` and和 `reserve` affect the bucket count, although `insert` can only invalidate iterators when the insertion causes the container's load to be greater than the maximum allowed. For most implementations this means that `insert` will only change the number of buckets when this happens. Iterators can be invalidated by calls to之外的成员函数如何影响桶数量，但 `insert` 操作仅当导致容器负载超过最大允许值时才会使迭代器失效。在大多数实现中，这意味着 `insert` 仅在此种情况下才会改变桶的数量。迭代器可能因调用 `insert`, 、 `rehash` and或 `reserve`. 而失效。
06/05/2026
User avatar admin

Translation uploaded
Iterator Invalidation
Iterator Invalidation迭代器失效
06/05/2026
User avatar admin

Translation uploaded
There are other differences, which are listed in the xref:regular.adoc#comparison[Comparison with Associative Containers] section.
There are other differences, which are listed in the xref:regular.adoc#comparison[Comparison with Associative Containers] section.其他差异列于 xref:regular.adoc#comparison[与关联容器的对比] 章节中。
06/05/2026
User avatar admin

Translation uploaded
can be in any order. For example, it might be:
can be in any order. For example, it might be:可能以任意顺序输出。例如，结果可能为：
06/05/2026
User avatar admin

Translation uploaded
But since the elements aren't ordered, the output of:
But since the elements aren't ordered, the output of:但由于元素不按顺序存储，以下代码的输出结果：
06/05/2026
User avatar admin

Translation uploaded
For readers without previous experience with hash containers but familiar with normal associative containers (`std::set`, `std::map`, `std::multiset` and `std::multimap`), Boost.Unordered containers are used in a similar manner:
For readers without previous experience with hash containers but familiar with normal associative containers (对于没有哈希容器经验但熟悉常规关联容器（ `std::set`, 、 `std::map`, 、 `std::multiset` and和 `std::multimap`), ）的读者，Boost.Unordered containers are used in a similar manner:容器的使用方式与之类似：
06/05/2026
User avatar admin

Translation uploaded
Boost.Unordered closed-addressing containers (`boost::unordered_set`, `boost::unordered_map`, `boost::unordered_multiset` and `boost::unordered_multimap`) are fully conformant with the C++ specification for unordered associative containers, so for those who know how to use `std::unordered_set`, `std::unordered_map`, etc., their homonyms in Boost.Unordered are drop-in replacements. The interface of open-addressing containers (`boost::unordered_node_set`, `boost::unordered_node_map`, `boost::unordered_flat_set` and `boost::unordered_flat_map`) is very similar, but they present some minor differences listed in the dedicated xref:compliance.adoc#compliance_open_addressing_containers[standard compliance section].
Boost.Unordered closed-addressing containers (的闭寻址容器（ `boost::unordered_++_++set`, 、 `boost::unordered_++_++map`, 、 `boost::unordered_++_++multiset` and与 `boost::unordered_++_++multimap`) are fully conformant with the C++ specification for unordered associative containers, so for those who know how to use ）完全符合 C{plus}{plus} 无序关联容器的标准规范。因此，对于熟悉 `std::unordered_++_++set`, 、 `std::unordered_map`, etc., their homonyms in Boost.Unordered are drop-in replacements. The interface of open-addressing containers (++_++map` 等用法的用户，可直接将其替换为Boost.Unordered 中的同名容器。开放寻址容器（ `boost::unordered_node_++_++node++_++set`, 、 `boost::unordered_node_++_++node++_++map`, 、 `boost::unordered_flat_++_++flat++_++set` and和 `boost::unordered_flat_map`) is very similar, but they present some minor differences listed in the dedicated++_++flat++_++map` ）的接口与之高度相似，但存在一些细微差异，详见专门的 xref:compliance.adoc#compliance_open_addressing_containers[standard compliance section].标准符合性章节] 。
06/05/2026
User avatar admin

Translation uploaded
:idprefix: regular_
:idprefix: regular_
06/05/2026
User avatar admin

Translation uploaded
[#regular] = Regular Containers
[#regular] = Regular Containers常规容器
06/05/2026
User avatar admin

File uploaded
Processed 430 strings from the uploaded files (skipped: 0, not found: 0, updated: 430).
File upload mode: Add as translation 06/05/2026
User avatar admin

Translation uploaded
Requires:;; If `x` is the `unordered_set` `it` points to, no modifying operations have been issued on `x` between loading of `x` and loading of `it`.
Requires:;; If要求;; 如果 `x` is the是 `it` 指向的 `unordered_set` `it` points to, no modifying operations have been issued on `x` between loading of `x` and loading of `it`.++_++set` ，则在加载 `x` 与加载 `it` 的时间间隔内，不得对 `x` 执行任何修改操作。
06/05/2026
User avatar admin

Translation uploaded
Makes an `iterator` (`const_iterator`) `it` point to the restored position of the original `iterator` (`const_iterator`) saved to the storage read by an archive (XML archive) `ar`.
Makes an使 `iterator` (（ `const_++_++iterator`) ） `it` point to the restored position of the original指向原始 `iterator` (（ `const_++_++iterator`) saved to the storage read by an archive (XML archive) `ar`. ）所恢复的位置。该原始迭代器已被保存到由归档（XML 归档） `ar` 读取的存储中。
06/05/2026
User avatar admin

Translation uploaded
Loading an iterator/const_iterator from an archive
Loading an iterator/const_iterator from an archive从归档加载迭代器/常量迭代器
06/05/2026
User avatar admin

Translation uploaded
---
---
:1544
06/05/2026
User avatar admin

Translation uploaded
Requires:;; The `unordered_set` `x` pointed to by `it` has been previously saved to `ar`, and no modifying operations have been issued on `x` between saving of `x` and saving of `it`.
Requires:;; The要求;; 迭代器 `it` 指向的 `unordered_++_++set` `x` pointed to by `it` has been previously saved to `ar`, and no modifying operations have been issued on `x` between saving of `x` and saving of `it`.必须已预先保存至归档 `ar` ，且在保存 `x` 和保存 `it` 的时间间隔内 `x` 执行任何修改操作。
06/05/2026

Search