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-24 20:06+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-07-concepts-fields-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 "Fields"
msgstr "字段"

#. type: paragraph
#: 12
msgid ""
"An instance of [*Fields] is a container for holding HTTP header fields and "
"their values. The implementation also calls upon the container to store the "
"request target and non-standard strings for method and obsolete reason "
"phrase as needed. Types which meet these requirements can always be "
"serialized."
msgstr ""
"`Fields` 的实例是一个用于存储 HTTP 报文字段及其值的容器。该实现还会根据需要调"
"用此容器来存储请求目标，以及非标准的方法字符串和过时的原因短语字符串。满足这"
"些要求的类型始终可以进行序列化。"

#. type: heading
#: 18
msgid "Associated Types"
msgstr "关联类型"

#. type: list
#: 20
msgid ""
"* [link beast.ref.boost__beast__http__is_fields `is_fields`]\n"
"* __FieldsWriter__"
msgstr ""
"* [link beast.ref.boost__beast__http__is_fields `is_fields`]\n"
"* __FieldsWriter__"

#. type: heading
#: 23
msgid "Requirements"
msgstr "要求"

#. type: paragraph
#: 25
msgid "In this table:"
msgstr "在下表中:"

#. type: list
#: 27
msgid ""
"* `F` denotes a type that meets the requirements of [*Fields].\n"
"* `W` denotes a type meeting the requirements of __FieldsWriter__.\n"
"* `a` denotes a value of type `F`.\n"
"* `c` denotes a (possibly const) value of type `F`.\n"
"* `b` is a value of type `bool`\n"
"* `n` is a value of type `boost::optional<std::uint64_t>`.\n"
"* `s` is a value of type [link beast.ref.boost__beast__string_view "
"`string_view`].\n"
"* `v` is a value of type `unsigned int` representing the HTTP-version."
msgstr ""
"* `F` 表示满足 [*Fields] 要求的类型。\n"
"* `W` 表示满足 __FieldsWriter__ 要求的类型。\n"
"* `a` 表示类型为 `F` 的值。\n"
"* `c` 表示类型为 `F` 的值（可能带有 const 限定）。\n"
"* `b` 表示类型为 `bool` 的值。\n"
"* `n` 表示类型为 `boost::optional<std::uint64_t>` 的值。\n"
"* `s` 表示类型为 [link beast.ref.boost__beast__string_view `string_view`] 的"
"值。\n"
"* `v` 表示类型为 `unsigned int` 的值，用于表示 HTTP 版本。"

#. type: table title
#: 36
msgid "Valid expressions"
msgstr "有效表达式"

#. type: table cell
#: 36
msgid "Expression"
msgstr "表达式"

#. type: table cell
#: 36
msgid "Type"
msgstr "类型"

#. type: table cell
#: 36
msgid "Semantics, Pre/Post-conditions"
msgstr "语义，前置条件 / 后置条件"

#. type: table cell
#: 36
msgid "`F::writer`"
msgstr "`F::writer`"

#. type: table cell
#: 36
msgid "`W`"
msgstr "`W`"

#. type: table cell
#: 36
msgid "A type which meets the requirements of __FieldsWriter__."
msgstr "满足 __FieldsWriter__ 要求的类型。"

#. type: table cell
#: 36
msgid "`c.get_method_impl()`"
msgstr "`c.get_method_impl()`"

#. type: table cell
#.
#: 36
msgctxt "36"
msgid "`string_view`"
msgstr ""

#. type: table cell
#: 36
msgid ""
"Returns the method text. The implementation only calls this function for "
"request headers when retrieving the method text previously set with a call "
"to `set_method_impl` using a non-empty string."
msgstr ""
"返回方法文本。仅当使用非空字符串调用 `set_method_impl` 设置了方法文本后，在检"
"索请求头时，实现才会调用此函数。"

#. type: table cell
#: 36
msgid "`c.get_target_impl()`"
msgstr "`c.get_target_impl()`"

#. type: table cell
#: 36
msgid ""
"Returns the target string. The implementation only calls this function for "
"request headers."
msgstr "返回目标字符串。该函数仅在处理请求头时由实现调用。"

#. type: table cell
#: 36
msgid "`c.get_reason_impl()`"
msgstr "`c.get_reason_impl()`"

#. type: table cell
#: 36
msgid ""
"Returns the obsolete request text. The implementation only calls this for "
"response headers when retrieving the reason text previously set with a call "
"to `set_reason_impl` using a non-empty string."
msgstr ""
"返回过时的请求文本。仅当使用非空字符串调用 `set_reason_impl` 设置了原因文本后"
"，在检索响应头时，实现才会调用此函数。"

#. type: table cell
#: 36
msgid "`c.get_chunked_impl()`"
msgstr "`c.get_chunked_impl()`"

#. type: table cell
#.
#: 36
msgctxt "36"
msgid "`bool`"
msgstr ""

#. type: table cell
#: 36
msgid ""
"Returns `true` if the [@https://tools.ietf.org/html/rfc7230#section-3.3.1 "
"[*Transfer-Encoding]] field value indicates that the payload is chunk "
"encoded. Both of these conditions must be true: [itemized_list [ The "
"Transfer-Encoding field is present in the message. ][ The last item in value "
"of the field is \"chunked\". ]]"
msgstr ""
"如果 [@https://tools.ietf.org/html/rfc7230#section-3.3.1 [*Transfer-"
"Encoding]] 字段值表明负载已进行分块编码，则返回 `true`。必须同时满足以下两个"
"条件：[itemized_list [ 消息中存在 Transfer-Encoding 字段。 ][ 该字段值的最后"
"一项为 \"chunked\"。 ]]"

#. type: table cell
#: 36
msgid "`c.get_keep_alive_impl(v)`"
msgstr "`c.get_keep_alive_impl(v)`"

#. type: table cell
#: 36
msgid ""
"Returns `true` if the semantics of the [@https://tools.ietf.org/html/"
"rfc7230#section-6.1 [*Connection]] field and version indicate that the "
"connection should remain open after the corresponding response is "
"transmitted or received:\n"
"\n"
"[itemized_list [ If `(v < 11)` the function returns `true` if the \"keep-"
"alive\" token is present in the Connection field value. Otherwise the "
"function returns `false`. ][ If `(v == 11)`, the function returns `false` if "
"the \"close\" token is present in the Connection field value. Otherwise the "
"function returns `true`. ]]"
msgstr ""
"如果 [@https://tools.ietf.org/html/rfc7230#section-6.1 [*Connection]] 字段的"
"语义和版本表明，在发送或接收相应响应后连接应保持打开，则返回 true：\n"
"[itemized_list [ 如果 (v < 11)，当 Connection 字段值中存在 \"keep-alive\" 标"
"记时函数返回 true，否则返回 false。 ][ 如果 (v == 11)，当 Connection 字段值中"
"存在 \"close\" 标记时函数返回 false，否则返回 true。 ]]"

#. type: table cell
#: 36
msgid "`c.has_content_length()`"
msgstr "`c.has_content_length()`"

#. type: table cell
#: 36
msgid ""
"Returns `true` if the [@https://tools.ietf.org/html/rfc7230#section-3.3.2 "
"[*Content-Length]] field is present."
msgstr ""
"如果存在 @https://tools.ietf.org/html/rfc7230#section-3.3.2 [Content-Length] "
"字段，则返回 true。"

#. type: table cell
#: 36
msgid "`a.set_method_impl(s)`"
msgstr "`a.set_method_impl(s)`"

#. type: table cell
#: 36
msgid ""
"Stores a copy of `s` as the method text, or erases the previously stored "
"value if `s` is empty. The implementation only calls this function for "
"request headers. This function may throw `std::invalid_argument` if the "
"operation is not supported by the container."
msgstr ""
"将 `s` 的副本存储为方法文本；若 `s` 为空，则擦除先前存储的值。此函数仅由实现"
"对请求头进行调用。如果容器不支持该操作，函数可能会抛出 "
"`std::invalid_argument` 异常。"

#. type: table cell
#: 36
msgid "`a.set_target_impl(s)`"
msgstr "`a.set_target_impl(s)`"

#. type: table cell
#: 36
msgid ""
"Stores a copy of `s` as the target, or erases the previously stored value if "
"`s` is empty. The implementation only calls this function for request "
"headers. This function may throw `std::invalid_argument` if the operation is "
"not supported by the container."
msgstr ""
"将 `s` 的副本存储为目标；若 `s` 为空，则擦除先前存储的值。此函数仅由实现对请"
"求头进行调用。如果容器不支持该操作，函数可能会抛出 `std::invalid_argument` 异"
"常。"

#. type: table cell
#: 36
msgid "`a.set_reason_impl(s)`"
msgstr "`a.set_reason_impl(s)`"

#. type: table cell
#: 36
msgid ""
"Stores a copy of `s` as the reason text, or erases the previously stored "
"value of the reason text if `s` is empty. The implementation only calls this "
"function for request headers. This function may throw "
"`std::invalid_argument` if the operation is not supported by the container."
msgstr ""
"将 `s` 的副本存储为原因文本；若 `s` 为空，则擦除先前存储的原因文本。此函数仅"
"由实现对请求头进行调用。如果容器不支持该操作，函数可能会抛出 "
"`std::invalid_argument` 异常。"

#. type: table cell
#: 36
msgid "`a.set_chunked_impl(b)`"
msgstr "`a.set_chunked_impl(b)`"

#. type: table cell
#: 36
msgid ""
"Adjusts the [@https://tools.ietf.org/html/rfc7230#section-3.3.1 [*Transfer-"
"Encoding]] field value as follows:\n"
"\n"
"[itemized_list [ If `b` is `true`, the \"chunked\" token is appended to the "
"list of encodings if it does not already appear last in the list. If the "
"Transfer-Encoding field is absent, the field will be inserted to the "
"container with the value \"chunked\". ][ If `b` is `false, the \"chunked\" "
"token is removed from the list of encodings if it appears last in the list. "
"If the result of the removal leaves the list of encodings empty, the "
"Transfer-Encoding field shall not appear when the associated "
"__FieldsWriter__ serializes the fields. ]]\n"
"\n"
"If the result of adjusting the field value produces an empty string, the "
"field is removed from the container."
msgstr ""
"根据 [@https://tools.ietf.org/html/rfc7230#section-3.3.1 [*Transfer-"
"Encoding]] 字段值进行调整：\n"
"\n"
"- 如果 `b` 为 `true`，且 \"chunked\" 标记尚未位于编码列表末尾，则将其追加到列"
"表末尾。如果不存在 Transfer-Encoding 字段，则向容器插入该字段，其值为 "
"\"chunked\"。\n"
"- 如果 `b` 为 `false`，且 \"chunked\" 标记位于编码列表末尾，则将其从列表中移"
"除。如果移除后编码列表为空，则当关联的 `__FieldsWriter__` 序列化字段时，"
"Transfer-Encoding 字段不应出现。\n"
"\n"
"如果调整字段值的结果产生空字符串，则从容器中移除该字段。"

#. type: table cell
#: 36
msgid "`a.set_content_length_impl(n)`"
msgstr "`a.set_content_length_impl(n)`"

#. type: table cell
#: 36
msgid ""
"Adjusts the [@https://tools.ietf.org/html/rfc7230#section-3.3.2 [*Content-"
"Length]] field value as follows:\n"
"\n"
"[itemized_list [ If `n` contains a value, the Content-Length field will be "
"set to the text representation of the value. Any previous Content-Length "
"fields are removed from the container. ][ If `n` does not contain a value, "
"any present Content-Length fields are removed from the container. ]]"
msgstr ""
"根据 [@https://tools.ietf.org/html/rfc7230#section-3.3.2 [*Content-Length]] "
"字段值进行如下调整：\n"
"\n"
"- 如果 `n` 包含一个值，则将 Content-Length 字段设置为该值的文本表示。从容器中"
"移除任何先前存在的 Content-Length 字段。\n"
"- 如果 `n` 不包含值，则从容器中移除任何存在的 Content-Length 字段。"

#. type: table cell
#: 36
msgid "`a.set_keep_alive_impl(v,b)`"
msgstr "`a.set_keep_alive_impl(v,b)`"

#. type: table cell
#: 36
msgid ""
"Adjusts the [@https://tools.ietf.org/html/rfc7230#section-6.1 [*Connection]] "
"field value depending on the values of `v` and `b`. The field value is "
"treated as [@https://tools.ietf.org/html/rfc7230#section-6.1 ['connection-"
"option]] (rfc7230).\n"
"\n"
"[itemized_list [ If `(v < 11 && b)`, then all \"close\" tokens present in "
"the value are removed, and the \"keep-alive\" token is added to the value if "
"it is not already present. ][ If `(v < 11 && ! b)`, then all \"close\" and "
"\"keep-alive\" tokens present in the value are removed.\n"
"\n"
"][ If `(v == 11 && b)`, then all \"keep-alive\" and \"close\" tokens present "
"in the value are removed. ][ If `(v == 11 && ! b)`, then all \"keep-alive\" "
"tokens present in the value are removed, and the \"close\" token is added to "
"the value if it is not already present. ]]\n"
"\n"
"If the result of adjusting the field value produces an empty string, the "
"field is removed from the container."
msgstr ""
"根据 [@https://tools.ietf.org/html/rfc7230#section-6.1 [*Connection]] 字段值"
"以及 `v` 和 `b` 的值进行如下调整。该字段值被视为 [@https://tools.ietf.org/"
"html/rfc7230#section-6.1 ['connection-option]] (rfc7230)。\n"
"\n"
"- 如果 `(v < 11 && b)`，则从字段值中移除所有 \"close\" 标记，若 \"keep-"
"alive\" 标记尚不存在，则将其添加到字段值中。\n"
"- 如果 `(v < 11 && !b)`，则从字段值中移除所有 \"close\" 和 \"keep-alive\" 标"
"记。\n"
"- 如果 `(v == 11 && b)`，则从字段值中移除所有 \"keep-alive\" 和 \"close\" 标"
"记。\n"
"- 如果 `(v == 11 && !b)`，则从字段值中移除所有 \"keep-alive\" 标记，若 "
"\"close\" 标记尚不存在，则将其添加到字段值中。\n"
"\n"
"如果调整字段值的结果产生空字符串，则从容器中移除该字段。"

#. type: heading
#: 224
msgid "Exemplar"
msgstr "示例"

#. type: heading
#: 228
msgid "Models"
msgstr "模型"

#. type: list
#: 230
msgid ""
"* [link beast.ref.boost__beast__http__basic_fields `basic_fields`]\n"
"* [link beast.ref.boost__beast__http__fields `fields`]"
msgstr ""
"* [link beast.ref.boost__beast__http__basic_fields `basic_fields`]\n"
"* [link beast.ref.boost__beast__http__fields `fields`]"