Zen

Translation

Changes the number of buckets so that there at least `n` buckets, and so that the load factor is less than the maximum load factor.
34/1310 · 131

Sign in to save translations.

Key English Chinese (Simplified Han script) Actions
Suggest a maximum load factor by calling `max_load_factor`.
用户可通过调用 `max_load_factor` 方法来设定最大负载因子的建议值。
`max_load_factor` doesn't let you set the maximum load factor yourself, it just lets you give a _hint_. And even then, the standard doesn't actually require the container to pay much attention to this value. The only time the load factor is _required_ to be less than the maximum is following a call to `rehash`. But most implementations will try to keep the number of elements below the max load factor, and set the maximum load factor to be the same as or close to the hint - unless your hint is unreasonably small or large.
`max_load_factor` 并不允许用户自行设定最大负载因子，该方法仅用于提供__提示__。即便如此，标准也并未强制要求容器必须严格遵守该数值。唯一强制要求负载因子必须小于最大值的场景是在调用 `rehash` 方法之后。但大多数实现会尝试将元素数量维持在最大负载因子以下，并将最大负载因子设定为与提示值相同或接近——除非用户提供的提示值过小或过大。
:111
2+^h| *All containers* h|*Method* h|*Description*
2+^h| *所有容器* h|*方法* h|*描述*
`X(size_type n)`
`X(size_type n)`
Construct an empty container with at least `n` buckets (`X` is the container type).
构造一个至少包含 `n` 个桶的空容器（ `X` 表示容器类型）。
`X(InputIterator i, InputIterator j, size_type n)`
`X(InputIterator i, InputIterator j, size_type n)`
Construct an empty container with at least `n` buckets and insert elements from the range `[i, j)` (`X` is the container type).
构造一个至少包含 `n` 个桶的空容器，并插入范围 `[i, j)` 中的元素（ `X` 表示容器类型）。
`float load_factor() const`
`float load_factor() const`
The average number of elements per bucket.
返回每个桶的平均元素数量。
`float max_load_factor() const`
`float max_load_factor() const`
Returns the current maximum load factor.
返回当前的最大负载因子。
`float max_load_factor(float z)`
`float max_load_factor(float z)`
Changes the container's maximum load factor, using `z` as a hint. +
以 `z` 作为提示值来更改容器的最大负载因子。 +
**Open-addressing and concurrent containers:** this function does nothing: users are not allowed to change the maximum load factor.
**开放寻址与并发容器：**此函数无效，用户不允许更改最大负载因子。
`void rehash(size_type n)`
`void rehash(size_type n)`
Changes the number of buckets so that there at least `n` buckets, and so that the load factor is less than the maximum load factor.
调整桶的数量，使其至少为 `n` ，并确保负载因子小于最大负载因子。
2+^h| *Open-addressing and concurrent containers only* h|*Method* h|*Description*
2+^h| *仅限开放寻址与并发容器* h|*方法* h|*描述*
`size_type max_load() const`
`size_type max_load() const`
Returns the maximum number of allowed elements in the container before rehash.
返回容器触发重新哈希前所允许容纳的最大元素数量。
A note on `max_load` for open-addressing and concurrent containers: the maximum load will be (`max_load_factor() * bucket_count()`) right after `rehash` or on container creation, but may slightly decrease when erasing elements in high-load situations. For instance, if we have a `xref:reference/unordered_flat_map.adoc#unordered_flat_map[boost::unordered_flat_map]` with `size()` almost at `max_load()` level and then erase 1,000 elements, `max_load()` may decrease by around a few dozen elements. This is done internally by Boost.Unordered in order to keep its performance stable, and must be taken into account when planning for rehash-free insertions.
关于开放寻址与并发容器的 `max_load` 注意事项：在容器创建或执行 `rehash` 后，最大负载值将保持为 `max_load_factor() * bucket_count()` ；但在高负载场景下执行元素删除操作时，该值可能轻微下降。例如，若某个 xref:reference/unordered_flat_map.adoc#unordered_flat_map[boost::unordered_flat_map] 的 `size()` 已接近 `max_load()` 阈值，随后删除 1,000 个元素时， `max_load()` 可能减少约数十个元素。此机制是Boost.Unordered为保持性能稳定而采取的内部机制，用户在规划无重组插入操作时需予以考虑。
Key English Chinese (Simplified Han script) Actions
`size_type max_load() const`
`size_type max_load() const`
Specify the minimum number of buckets when constructing a container or when calling `rehash`.
用户可在构造容器或调用 `rehash` 方法时指定桶数量的最小值。
Suggest a maximum load factor by calling `max_load_factor`.
用户可通过调用 `max_load_factor` 方法来设定最大负载因子的建议值。
`max_load_factor` doesn't let you set the maximum load factor yourself, it just lets you give a _hint_. And even then, the standard doesn't actually require the container to pay much attention to this value. The only time the load factor is _required_ to be less than the maximum is following a call to `rehash`. But most implementations will try to keep the number of elements below the max load factor, and set the maximum load factor to be the same as or close to the hint - unless your hint is unreasonably small or large.
`max_load_factor` 并不允许用户自行设定最大负载因子，该方法仅用于提供__提示__。即便如此，标准也并未强制要求容器必须严格遵守该数值。唯一强制要求负载因子必须小于最大值的场景是在调用 `rehash` 方法之后。但大多数实现会尝试将元素数量维持在最大负载因子以下，并将最大负载因子设定为与提示值相同或接近——除非用户提供的提示值过小或过大。
Changes the number of buckets so that there at least `n` buckets, and so that the load factor is less than the maximum load factor.
调整桶的数量，使其至少为 `n` ，并确保负载因子小于最大负载因子。
2+^h| *Open-addressing and concurrent containers only* h|*Method* h|*Description*
2+^h| *仅限开放寻址与并发容器* h|*方法* h|*描述*
`X(size_type n)`
`X(size_type n)`
Construct an empty container with at least `n` buckets (`X` is the container type).
构造一个至少包含 `n` 个桶的空容器（ `X` 表示容器类型）。
`X(InputIterator i, InputIterator j, size_type n)`
`X(InputIterator i, InputIterator j, size_type n)`
Construct an empty container with at least `n` buckets and insert elements from the range `[i, j)` (`X` is the container type).
构造一个至少包含 `n` 个桶的空容器，并插入范围 `[i, j)` 中的元素（ `X` 表示容器类型）。
`float load_factor() const`
`float load_factor() const`
The average number of elements per bucket.
返回每个桶的平均元素数量。
`float max_load_factor() const`
`float max_load_factor() const`
Returns the current maximum load factor.
返回当前的最大负载因子。
`float max_load_factor(float z)`
`float max_load_factor(float z)`
Changes the container's maximum load factor, using `z` as a hint. +
以 `z` 作为提示值来更改容器的最大负载因子。 +
**Open-addressing and concurrent containers:** this function does nothing: users are not allowed to change the maximum load factor.
**开放寻址与并发容器：**此函数无效，用户不允许更改最大负载因子。
`void rehash(size_type n)`
`void rehash(size_type n)`
:111
2+^h| *All containers* h|*Method* h|*Description*
2+^h| *所有容器* h|*方法* h|*描述*
:48
2+^h| *All containers* h|*Method* h|*Description*
2+^h| *所有容器* h|*方法* h|*描述*

Loading…

User avatar admin

Translation uploaded
Changes the number of buckets so that there at least `n` buckets, and so that the load factor is less than the maximum load factor.
Changes the number of buckets so that there at least `n` buckets, and so that the load factor is less than the maximum load factor.调整桶的数量，使其至少为 `n` ，并确保负载因子小于最大负载因子。
06/05/2026
User avatar admin

String added in the repository
Changes the number of buckets so that there at least `n` buckets, and so that the load factor is less than the maximum load factor.
Changes the number of buckets so that there at least `n` buckets, and so that the load factor is less than the maximum load factor.
06/05/2026
Browse all string changes

Glossary

English Chinese (Simplified Han script)
No related strings found in the glossary.

String information

Flags
safe-html, strict-same
Unit identifier
51314
Source string location
:130
String age
06/05/2026
Last updated
06/05/2026
Source string age
06/05/2026
Translation file AsciiDoc file
doc/modules/ROOT/pages/buckets_zh_Hans.adoc, string 49 pending