User avatar Bstran

Translation changed
Enables the use of deprecated APIs within Beast.
Enables the use of deprecated APIs within Beast.启用 Beast 内部已弃用 API 的使用。
06/12/2026
User avatar Bstran

Translation changed
BOOST_BEAST_ALLOW_DEPRECATED
BOOST_BEAST_ALLOW_DEPRECATED
06/12/2026
User avatar Bstran

Translation changed
Enables the split compilation mode, which allows the user to compile definitions of non-template entities in a single translation unit, thus improving compilation speed. That translation unit has to include boost/beast/src.hpp in order to compile the definitions.
Enables the split compilation mode, which allows the user to compile definitions of non-template entities in a single translation unit, thus improving compilation speed. That translation unit has to include boost/beast/src.hpp in order to compile the definitions.启用分离编译模式。该模式下，用户可以将非模板实体的定义集中编译到单个翻译单元中，以提升编译速度。该翻译单元需包含 `boost/beast/src.hpp` 方可完成定义编译。
06/12/2026
User avatar Bstran

Translation changed
BOOST_BEAST_SEPARATE_COMPILATION
BOOST_BEAST_SEPARATE_COMPILATION —— 启用分离编译模式
06/12/2026
User avatar Bstran

Translation changed
Description
Description描述
06/12/2026
User avatar Bstran

Translation changed
Definition
Definition定义
06/12/2026
User avatar Bstran

Translation changed
Special Fields
Special Fields特殊字段
06/12/2026
User avatar Bstran

Translation changed
A number of configuration preprocessor definitions can be used to change the behavior of Beast. The user should assume that they introduce significant changes to the public part of this library's API and make sure that all translation units (usually files) compiled and linked into a program use the same combination of configuration macros, failure to do so may result in violations of ODR (One Definition Rule).
A number of configuration preprocessor definitions can be used to change the behavior of Beast. The user should assume that they introduce significant changes to the public part of this library's API and make sure that all translation units (usually files) compiled and linked into a program use the same combination of configuration macros, failure to do so may result in violations of ODR (One Definition Rule).Beast 提供多个配置预处理宏，用于调整库的行为。这些宏会显著影响本库的公共 API。用户需确保所有参与编译和链接的翻译单元（通常是源文件）都使用同一套配置宏组合，否则可能违反 ODR（单一定义规则）。
06/12/2026
User avatar Bstran

Translation changed
Configuration Preprocessor Definitions
Configuration Preprocessor Definitions配置预处理宏定义
06/12/2026
User avatar Bstran

Translation changed
The examples [path_link example/advanced/server/advanced_server.cpp advanced-server] and [path_link example/advanced/server-flex/advanced_server_flex.cpp advanced-server-flex] use this SSL detection function.
The examples示例 [path_link example/advanced/server/advanced_server.cpp advanced-server] and和 [path_link example/advanced/server-flex/advanced_server_flex.cpp advanced-server-flex] use this SSL detection function.使用了该 SSL 检测函数。
06/12/2026
User avatar Bstran

Translation changed
The boilerplate is all done, and now we need to implement the function call operator that turns this composed operation a completion handler with the signature `void(error_code, std::size_t)` which is exactly the signature needed when performing asynchronous reads. This function is a transformation of the synchronous version of `detect_ssl` above, but with the inversion of flow that characterizes code written in the callback style:
The boilerplate is all done, and now we need to implement the function call operator that turns this composed operation a completion handler with the signature `void(error_code, std::size_t)` which is exactly the signature needed when performing asynchronous reads. This function is a transformation of the synchronous version of `detect_ssl` above, but with the inversion of flow that characterizes code written in the callback style:样板代码已经全部完成，接下来需要实现函数调用运算符，使该组合操作成为一个具有 `void(error_code, std::size_t)` 签名的完成处理器，而这正是执行异步读取时所需的签名。该函数是对上述同步版本 `detect_ssl` 的一种转换，但与同步版本不同，它采用了回调风格代码特有的控制流反转方式：
06/12/2026
User avatar Bstran

Translation changed
Now we will declare our composed operation. There is a considerable amount of necessary boilerplate to get this right, but the result is worth the effort.
Now we will declare our composed operation. There is a considerable amount of necessary boilerplate to get this right, but the result is worth the effort.接下来声明组合操作。虽然需要编写不少必要的样板代码，但最终效果是值得的。
06/12/2026
User avatar Bstran

Translation changed
The initiating function definition itself is straightforward. We perform type checking on the parameters, and then let `net::async_initiate` capture the parameter list along with a copy of our initiation function object. Depending on the specialization of `async_result` for the type of `CompletionToken`, the initiation function may be invoked immediately. Alternatively, it may be invoked later, after the initiating function returns. This is known as "lazy execution," and allows efficient and expressive abstractions to be written.
The initiating function definition itself is straightforward. We perform type checking on the parameters, and then let `net::async_initiate` capture the parameter list along with a copy of our initiation function object. Depending on the specialization of `async_result` for the type of `CompletionToken`, the initiation function may be invoked immediately. Alternatively, it may be invoked later, after the initiating function returns. This is known as "lazy execution," and allows efficient and expressive abstractions to be written.发起函数的定义本身并不复杂：先对参数进行类型检查，再通过 `net::async_initiate` 捕获参数列表和发起函数对象的一个副本。根据 `CompletionToken` 类型对应的 `async_result` 特化版本，发起函数可以立即执行，也可以在发起函数返回之后再执行。后者称为“延迟执行”，这种机制便于编写高效且表达力强的抽象。
06/12/2026
User avatar Bstran

Translation changed
Here we forward declare the composed operation type, and provide the definition of the initiation function object. They are placed in the `detail` namespace since they should not be public:
Here we forward declare the composed operation type, and provide the definition of the initiation function object. They are placed in the `detail` namespace since they should not be public:这里先对组合操作类型进行前置声明，然后给出发起函数对象的定义。因为这些组件属于内部实现细节，不对外公开，所以都放在 `detail` 命名空间中：
06/12/2026
User avatar Bstran

Translation changed
* An "initiation" function object which when invoked with parameters
* An "initiation" function object which when invoked with parameters一个“发起”函数对象，当使用参数调用时
06/12/2026
User avatar Bstran

Translation changed
* An intermediate completion handler, called the "composed operation"
* An intermediate completion handler, called the "composed operation"一个中间完成处理器，称为“组合操作”
06/12/2026
User avatar Bstran

Translation changed
There are two additional components required to implement the initiating function:
There are two additional components required to implement the initiating function:实现发起函数还需要以下两个额外组件：
06/12/2026
User avatar Bstran

Translation changed
First we declare the initiating function and document the requirements, parameters, preconditions, and effects:
First we declare the initiating function and document the requirements, parameters, preconditions, and effects:首先声明发起函数，并说明其使用要求、参数、前置条件及功能效果：
06/12/2026
User avatar Bstran

Translation changed
Now that we have the synchronous version, we can attempt to model the asynchronous version similarly. A function which launches an asynchronous operation is called an ['initiating function]. While the synchronous version above produces an error code through an output parameter, the asynchronous version delivers the error code to a completion handler or other custom mechanism defined by the completion token. The signature of the initiating function reflects these differences.
Now that we have the synchronous version, we can attempt to model the asynchronous version similarly. A function which launches an asynchronous operation is called an ['initiating function]. While the synchronous version above produces an error code through an output parameter, the asynchronous version delivers the error code to a completion handler or other custom mechanism defined by the completion token. The signature of the initiating function reflects these differences.有了同步版本之后，可以尝试以类似方式构建异步版本。启动异步操作的函数称为发起函数。上述同步版本通过输出参数返回错误码，而异步版本则通过完成处理器或由完成令牌定义的其他自定义机制来传递错误码。发起函数的签名反映了这些差异。
06/12/2026
User avatar Bstran

Translation changed
The synchronous version is implemented thusly:
The synchronous version is implemented thusly:同步版本的实现如下：
06/12/2026

Search