msgid ""
msgstr ""
"Project-Id-Version: Chinese (Simplified Han script) (Boost Beast Translation "
"(zh_Hans))\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-07-25 14:13+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Chinese (Simplified Han script) <https://"
"insights.cppalliance.org/weblate/projects/boost-beast-documentation-zh_Hans/"
"doc-qbk-03-core-7a-echo-qbk/zh_Hans/>\n"
"Language: zh_Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"
"X-Generator: Weblate 2026.5\n"

#. type: section title
#: 10
msgid "Echo __example__"
msgstr "回显 __示例__"

#. type: paragraph
#: 12
msgid ""
"This example develops an initiating function called [*echo]. The operation "
"will read up to the first newline on a stream, and then write the same line "
"including the newline back on the stream. First we define the input "
"parameters and results, then declare our initiation function. For our echo "
"operation the only inputs are the stream and the completion token. The "
"output is the error code which is usually included in all completion handler "
"signatures."
msgstr ""
"该示例用于开发名为 [*echo] 的启动函数。该操作从流中读取数据，直到遇到第一个换"
"行符为止，然后将读取的内容（包含该换行符）写回流中。实现步骤如下：首先定义输"
"入参数与返回结果，然后声明启动函数。该回显操作的输入参数仅为流对象与完成令牌"
"，返回结果为错误码。该错误码通常包含在所有完成处理器的签名中。"

#. type: paragraph
#: 22
msgid ""
"Now that we have a declaration, we will define the body of the function. We "
"want to achieve the following goals: perform static type checking on the "
"input parameters, set up the return value as per __N3747__, and launch the "
"composed operation by constructing an intermediate, stateful completion "
"handler and invoking it."
msgstr ""
"完成函数声明后，我们再对该函数的实现部分进行定义。实现过程中需要满足以下几个"
"目标：对输入参数执行静态类型检查，按照 __N3747__ 规范设定返回值类型，同时构造"
"一个带有状态的中间完成处理器并调用该处理器，以此启动组合操作。"

#. type: paragraph
#: 28
msgid ""
"The initiating function contains a few relatively simple parts. There is the "
"customization of the return value type, static type checking, building the "
"return value type using the helper, and creating and launching the `echo_op` "
"composed operation object."
msgstr ""
"发起函数包含几个相对简单的部分：定制返回值类型、静态类型检查、使用辅助工具构"
"建返回值类型，以及创建并启动 `echo_op` 组合操作对象。"

#. type: paragraph
#: 33
msgid ""
"The implementation strategy is to make the composed object meet the "
"requirements of a completion handler by being movable, and by making it "
"invocable so it can be used as a continuation for the asynchronous "
"operations it launches. Rather than using `std::bind` or `boost::bind`, "
"which destroys the type information and therefore breaks the associators, we "
"will simply pass `std::move(*this)` as the completion handler parameter for "
"any operations that we initiate. For the move to work correctly, care must "
"be taken to ensure that no access to data members are made after the move "
"takes place. Here is the complete implementation of our composed operation:"
msgstr ""
"实现策略是让组合对象满足完成处理器的要求：一方面要支持移动语义，另一方面要使"
"其可调用，这样它就能作为其发起的异步操作的后续回调来使用。我们不使用 "
"`std::bind` 或 `boost::bind`，因为它们会丢失类型信息，从而破坏关联器。相反，"
"我们会直接把 `std::move(*this)` 作为完成处理器参数，传递给所发起的每个异步操"
"作。为确保移动操作能正确工作，需要注意在移动发生之后，不能再访问任何数据成员"
"。以下是该组合操作的完整实现："

#. type: paragraph
#: 45
msgid ""
"There are some common mistakes that should be avoided when writing composed "
"operations:"
msgstr "当编写组合操作时，需要避免以下几种常见错误："

#. type: list
#: 48
msgid "* Type erasing the final handler. This will cause undefined behavior."
msgstr "* 对最终处理器进行类型擦除，该操作会导致未定义行为。"

#. type: list
#: 50
msgid "* Forgetting to include a return statement after calling an"
msgstr "* 调用异步发起函数后忘记包含 return 语句"

#. type: list
#: 53
msgid "* Calling a synchronous function by accident. In general composed"
msgstr "* 意外调用同步函数。通常情况下，"

#. type: list
#: 57
msgid "* Forgetting to provide `executor_type` and `get_executor` for the"
msgstr "* 忘记提供 `executor_type` 和 `get_executor` 成员（为组合操作提供）。"

#. type: list
#: 65
msgid ""
"* Forgetting to create an object of type __executor_work_guard__ with the"
msgstr "* 忘记创建 __executor_work_guard__ 对象（使用执行器来创建）。"

#. type: list
#: 68
msgid "* For operations which complete immediately (i.e. without calling an"
msgstr "对于立即完成的操作（即无需调用异步发起函数即可完成的操作），"

#. type: paragraph
#: 77
msgid ""
"The listing for a complete, runnable version of this example is in "
"[path_link example/echo-op/echo_op.cpp echo_op.cpp]."
msgstr ""
"该示例的完整可运行代码参见 [path_link example/echo-op/echo_op.cpp "
"echo_op.cpp]。"