Zen

Translation

type: table cell
This function is called by the implementation to determine the maximum number of allowed bytes to be transferred in the next read operation. The actual number of bytes subsequently transferred may be less than this number.

If the policy returns a value of zero, the read operation will asynchronously wait until the next timer interval before retrying. When the retry occurs, this function will be called again.
103/4120 · 412

Sign in to save translations.

Key English Chinese (Simplified Han script) Actions
* [link beast.ref.boost__beast__rate_policy_access `rate_policy_access`]
* [link beast.ref.boost__beast__rate_policy_access `rate_policy_access`]
These requirements may undergo non-backward compatible
这些要求可能会发生不向后兼容的变更。
Requirements
要求
In this table:
在下表中：
* `P` denotes a type that meets the requirements of [*RatePolicy].
* `x` denotes an xvalue of type `P`
* `a` denotes a value of type `P`.
* `n` denotes a value of type `std::size_t`
* `P` 表示一个满足 [*RatePolicy] 要求的类型。
* `x` 表示一个类型为 `P` 的将亡值（xvalue）。
* `a` 表示一个类型为 `P` 的值。
* `n` 表示一个类型为 `std::size_t` 的值。
Valid expressions
有效表达式
Expression
表达式
Type
类型
Semantics, Pre/Post-conditions
语义，前置/后置条件
`P a(x)`
`P a(x)`
Requires ['MoveConstructible].
要求满足 ['MoveConstructible]。
`friend rate_policy_access`
`friend rate_policy_access`
The member functions required in `P` should be private. [link beast.ref.boost__beast__rate_policy_access `rate_policy_access`] must be a friend of `P` for the implementation to gain access to the required member functions.
`P` 中要求的成员函数应当是私有的。[link beast.ref.boost__beast__rate_policy_access `rate_policy_access`] 必须是 `P` 的友元，以便实现能够访问这些必需的成员函数。
`a.available_read_bytes()`
`a.available_read_bytes()`
36
`std::size_t`
 
This function is called by the implementation to determine the maximum number of allowed bytes to be transferred in the next read operation. The actual number of bytes subsequently transferred may be less than this number.

If the policy returns a value of zero, the read operation will asynchronously wait until the next timer interval before retrying. When the retry occurs, this function will be called again.
实现会调用此函数，以确定下一次读取操作允许传输的最大字节数。随后实际传输的字节数可能会小于该数值。

如果该策略返回零值，读取操作将异步等待直到下一个计时器间隔再进行重试。当重试发生时，此函数将再次被调用。
`a.available_write_bytes()`
`a.available_write_bytes()`
This function is called by the implementation to determine the maximum number of allowed bytes to be transferred in the next write operation. The actual number of bytes subsequently transferred may be less than this number.

If the policy returns a value of zero, the read operation will asynchronously wait until the next timer interval before retrying. When the retry occurs, this function will be called again.
实现会调用此函数，以确定下一次写入操作允许传输的最大字节数。随后实际传输的字节数可能会小于该数值。
如果该策略返回零值，写入操作将异步等待直到下一个计时器间隔再进行重试。当重试发生时，此函数将再次被调用。
`a.transfer_read_bytes(n)`
`a.transfer_read_bytes(n)`
The implementation calls this function to inform the policy that `n` bytes were successfully transferred in the most recent read operation. The policy object may optionally use this information to calculate throughputs and/or inform the algorithm used to determine subsequently queried transfer maximums.
实现会调用此函数，以通知策略在最近一次读取操作中已成功传输了 `n` 个字节。策略对象可以选择性地利用此信息来计算吞吐量，和/或用于优化后续查询传输最大值时所使用的算法。
`a.transfer_write_bytes(n)`
`a.transfer_write_bytes(n)`
The implementation calls this function to inform the policy that `n` bytes were successfully transferred in the most recent write operation. The policy object may optionally use this information to calculate throughputs and/or inform the algorithm used to determine subsequently queried transfer limits.
实现会调用此函数，以通知策略在最近一次写入操作中已成功传输了 `n` 个字节。策略对象可以选择性地利用此信息来计算吞吐量，和/或用于优化后续查询传输上限时所使用的算法。
`a.on_timer()`
`a.on_timer()`
The implementation calls this function every time the internal timer expires. The policy object may optionally use this opportunity to calculate elapsed time and throughput, and/or inform the algorithm used to determine subsequently queried transfer limits.
每当内部计时器到期时，实现都会调用此函数。策略对象可以选择性地利用此机会来计算已用时间和吞吐量，和/或用于优化后续查询传输上限时所使用的算法。
Exemplar
示例
Models
模型
* [link beast.ref.boost__beast__simple_rate_policy `simple_rate_policy`]
* [link beast.ref.boost__beast__unlimited_rate_policy `unlimited_rate_policy`]
* [link beast.ref.boost__beast__simple_rate_policy `simple_rate_policy`]
* [link beast.ref.boost__beast__unlimited_rate_policy `unlimited_rate_policy`]
English Chinese (Simplified Han script) Actions
An instance of [*RatePolicy] is associated with a [link beast.ref.boost__beast__basic_stream `basic_stream`], and controls the rate at which bytes may be independently sent and received. This may be used to achieve fine-grained bandwidth management and flow control.
`RatePolicy` 的实例与 [link beast.ref.boost__beast__basic_stream `basic_stream`] 相关联，用于控制独立发送和接收字节的速率。这可用于实现细粒度的带宽管理和流量控制。
Requirements
要求
Exemplar
示例
* [link beast.ref.boost__beast__simple_rate_policy `simple_rate_policy`]
* [link beast.ref.boost__beast__unlimited_rate_policy `unlimited_rate_policy`]
* [link beast.ref.boost__beast__simple_rate_policy `simple_rate_policy`]
* [link beast.ref.boost__beast__unlimited_rate_policy `unlimited_rate_policy`]
`a.available_read_bytes()`
`a.available_read_bytes()`
The member functions required in `P` should be private. [link beast.ref.boost__beast__rate_policy_access `rate_policy_access`] must be a friend of `P` for the implementation to gain access to the required member functions.
`P` 中要求的成员函数应当是私有的。[link beast.ref.boost__beast__rate_policy_access `rate_policy_access`] 必须是 `P` 的友元，以便实现能够访问这些必需的成员函数。
This function is called by the implementation to determine the maximum number of allowed bytes to be transferred in the next read operation. The actual number of bytes subsequently transferred may be less than this number.

If the policy returns a value of zero, the read operation will asynchronously wait until the next timer interval before retrying. When the retry occurs, this function will be called again.
实现会调用此函数，以确定下一次读取操作允许传输的最大字节数。随后实际传输的字节数可能会小于该数值。

如果该策略返回零值，读取操作将异步等待直到下一个计时器间隔再进行重试。当重试发生时，此函数将再次被调用。
This function is called by the implementation to determine the maximum number of allowed bytes to be transferred in the next write operation. The actual number of bytes subsequently transferred may be less than this number.

If the policy returns a value of zero, the read operation will asynchronously wait until the next timer interval before retrying. When the retry occurs, this function will be called again.
实现会调用此函数，以确定下一次写入操作允许传输的最大字节数。随后实际传输的字节数可能会小于该数值。
如果该策略返回零值，写入操作将异步等待直到下一个计时器间隔再进行重试。当重试发生时，此函数将再次被调用。
`P a(x)`
`P a(x)`
`a.on_timer()`
`a.on_timer()`
Expression
表达式
`a.transfer_write_bytes(n)`
`a.transfer_write_bytes(n)`
`friend rate_policy_access`
`friend rate_policy_access`
These requirements may undergo non-backward compatible
这些要求可能会发生不向后兼容的变更。
Requires ['MoveConstructible].
要求满足 ['MoveConstructible]。
The implementation calls this function to inform the policy that `n` bytes were successfully transferred in the most recent write operation. The policy object may optionally use this information to calculate throughputs and/or inform the algorithm used to determine subsequently queried transfer limits.
实现会调用此函数，以通知策略在最近一次写入操作中已成功传输了 `n` 个字节。策略对象可以选择性地利用此信息来计算吞吐量，和/或用于优化后续查询传输上限时所使用的算法。
* `P` denotes a type that meets the requirements of [*RatePolicy].
* `x` denotes an xvalue of type `P`
* `a` denotes a value of type `P`.
* `n` denotes a value of type `std::size_t`
* `P` 表示一个满足 [*RatePolicy] 要求的类型。
* `x` 表示一个类型为 `P` 的将亡值（xvalue）。
* `a` 表示一个类型为 `P` 的值。
* `n` 表示一个类型为 `std::size_t` 的值。
The implementation calls this function to inform the policy that `n` bytes were successfully transferred in the most recent read operation. The policy object may optionally use this information to calculate throughputs and/or inform the algorithm used to determine subsequently queried transfer maximums.
实现会调用此函数，以通知策略在最近一次读取操作中已成功传输了 `n` 个字节。策略对象可以选择性地利用此信息来计算吞吐量，和/或用于优化后续查询传输最大值时所使用的算法。
`a.transfer_read_bytes(n)`
`a.transfer_read_bytes(n)`
Semantics, Pre/Post-conditions
语义，前置/后置条件
Valid expressions
有效表达式
`a.available_write_bytes()`
`a.available_write_bytes()`

Loading…

User avatar Bstran

Translation changed
This function is called by the implementation to determine the maximum number of allowed bytes to be transferred in the next read operation. The actual number of bytes subsequently transferred may be less than this number.

If the policy returns a value of zero, the read operation will asynchronously wait until the next timer interval before retrying. When the retry occurs, this function will be called again.
This function is called by the implementation to determine the maximum number of allowed bytes to be transferred in the next read operation. The actual number of bytes subsequently transferred may be less than this number.

If the policy returns a value of zero, the read operation will asynchronously wait until the next timer interval before retrying. When the retry occurs, this function will be called again.实现会调用此函数，以确定下一次读取操作允许传输的最大字节数。随后实际传输的字节数可能会小于该数值。

如果该策略返回零值，读取操作将异步等待直到下一个计时器间隔再进行重试。当重试发生时，此函数将再次被调用。
06/19/2026
User avatar admin

String added in the repository
This function is called by the implementation to determine the maximum number of allowed bytes to be transferred in the next read operation. The actual number of bytes subsequently transferred may be less than this number.

If the policy returns a value of zero, the read operation will asynchronously wait until the next timer interval before retrying. When the retry occurs, this function will be called again.
This function is called by the implementation to determine the maximum number of allowed bytes to be transferred in the next read operation. The actual number of bytes subsequently transferred may be less than this number.

If the policy returns a value of zero, the read operation will asynchronously wait until the next timer interval before retrying. When the retry occurs, this function will be called again.
06/05/2026
Browse all string changes

Glossary

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

String information

Source string description
type: table cell
Unit identifier
59033
Source string location
string ID 36
String age
06/05/2026
Last updated
06/26/2026
Source string age
06/05/2026
Translation file QuickBook file
doc/qbk/07_concepts/RatePolicy_zh_Hans.qbk, string 19