msgid "" msgstr "" "Project-Id-Version: Chinese (Simplified Han script) (Boost Json Translation " "(zh_Hans))\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2026-06-06 13:38+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese (Simplified Han script) \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" #: :12 #, safe-html, strict-same msgid "" "= Parsing Parsing is the process where a serialized JSON text is validated " "and decomposed into elements. The library provides these functions and types " "to assist with parsing:" msgstr "" "= 解析 解析是将序列化的JSON文本验证并分解为元素的过程。该库提供以下函数和类型" "来辅助解析：" #: :18 #, safe-html, strict-same msgid "Name" msgstr "" "一个 SAX 推送式解析器实现，它将序列化的 JSON 文本转换为对用户提供的处理器的一" "系列成员函数调用，从而允许自定义内存中文档的表示行为。" #: :18 #, safe-html, strict-same msgid "Description" msgstr "描述" #: :18 #, safe-html, strict-same msgid "<>" msgstr "<>" #: :18 #, safe-html, strict-same msgid "" "A SAX push parser implementation which converts a serialized JSON text into" msgstr "一个 SAX 推送式解析器实现，它将序列化的 JSON 文本转换" #: :23 #, safe-html, strict-same msgid "" "a series of member function calls to a user provided handler. This allows " "custom behaviors to be implemented for representing the document in memory." msgstr "为对用户提供的处理器的一系列成员函数调用，从而允许自定义内存中文档的表示行为" #: :26 #, safe-html, strict-same msgid "<>" msgstr "<>" #: :26 #, safe-html, strict-same msgid "A structure used to select which extensions are enabled during parsing." msgstr "一种结构，用于选择在解析期间启用哪些扩展。" #: :26 #, safe-html, strict-same msgid "<>" msgstr "<>" #: :26 #, safe-html, strict-same msgid "Parse a string containing a complete serialized JSON text, and return" msgstr "解析包含完整序列化 JSON 文本的字符串，并返回" #: :31 #, safe-html, strict-same msgid "a <>." msgstr "一个 <>。" #: :33 #, safe-html, strict-same msgid "<>" msgstr "<>" #: :33 #, safe-html, strict-same msgctxt ":33" msgid "" "A stateful DOM parser object which may be used to efficiently parse a series" msgstr "一种有状态的 DOM 解析器对象，可用于高效解析" #: :35 #, safe-html, strict-same msgid "" "of JSON texts each contained in a single contiguous character buffer, " "returning each result as a <>." msgstr "" "一系列 JSON 文本（每个文本均位于单独的连续字符缓冲区中），并将每个结果作" "为<>返回。" #: :38 #, safe-html, strict-same msgid "<>" msgstr "<>" #: :38 #, safe-html, strict-same msgctxt ":38" msgid "" "A stateful DOM parser object which may be used to efficiently parse a series" msgstr "一种有状态的DOM解析器对象，可用于高效地增量解析" #: :40 #, safe-html, strict-same msgid "of JSON texts incrementally, returning each result as a <>." msgstr "一系列JSON文本，并将每个结果作为<>返回" #: :42 #, safe-html, strict-same msgid "<>" msgstr "<>" #: :42 #, safe-html, strict-same msgid "" "A low level building block used for efficiently building a <>. The" msgstr "一种用于高效构建 <> 的低层构建块。" #: :44 #, safe-html, strict-same msgid "" "parsers use this internally, and users may use it to adapt foreign parsers " "to produce this library's containers. |===" msgstr "解析器在内部使用它，用户也可以使用它来适配外部解析器以生成此库的容器。|===" #: :48 #, safe-html, strict-same msgid "" "The <> function offers a simple interface for converting a " "serialized JSON text to a <> in a single function call. This " "overload uses exceptions to indicate errors:" msgstr "" "<> 函数提供了一个简单接口，用于在单个函数调用中将序列化的" "JSON文本转换为<>。此重载使用异常来指示错误：" #: :57 #, safe-html, strict-same msgid "Alternatively, an {ref_error_code} can be used:" msgstr "或者，可以使用{ref_error_code}：" #: :64 #, safe-html, strict-same msgid "" "Even when using error codes, exceptions thrown from the underlying " "{ref_memory_resource} are still possible:" msgstr "即使使用错误码，底层 {ref_memory_resource} 仍可能抛出异常：" #: :72 #, safe-html, strict-same msgid "" "The <> returned in the preceding examples use the " "<>. The following code uses " "a <>, which results in faster parsing. `jv` is " "marked `const` to prevent subsequent modification, because containers using " "a monotonic resource waste memory when mutated." msgstr "" "前述示例中返回的 <> 使用了 " "<>（默认内存" "资源）。以下代码使用了 <>，从而实现更快的解析" "。`jv` 被标记为 `const` 以防止后续修改，因为使用单调内存资源的容器在被修改时" "会浪费内存。" #: :83 #, safe-html, strict-same msgid "Non-Standard JSON" msgstr "非标准JSON" #: :84 #, safe-html, strict-same msgid "" "Unless otherwise specified, the parser in this library is strict. It " "recognizes only valid, standard JSON. The parser can be configured to allow " "certain non-standard extensions by filling in a <> " "structure and passing it by value. By default all extensions are disabled:" msgstr "" "除非另有说明，本库中的解析器采用严格模式，仅识别有效的标准 JSON。通过填充一" "个 <> 结构并按值传递它来配置解析器，以允许某些非标准" "扩展。默认情况下，所有扩展都被禁用：" #: :94 #, safe-html, strict-same msgid "" "When building with {cpp}20 or later, the use of https://en.cppreference.com/" "w/cpp/language/aggregate_initialization#Designated_initializers[designated " "initializers] with <> is possible:" msgstr "" "当使用 {cpp}20 或更高版本构建时，可以对 <> 使用 " "https://en.cppreference.com/w/cpp/language/" "aggregate_initialization#Designated_initializers[指定初始化器]：" #: :103 #, safe-html, strict-same msgid "" "When `allow_invalid_utf16` is enabled, the parser will not throw an error in " "the case of illegal leading, trailing, or half a surrogate. Instead, it will " "replace the invalid UTF-16 code point(s) with the Unicode replacement " "character." msgstr "" "启用 allow_invalid_utf16 后，解析器在遇到非法的前导代理、尾随代理或半个代理时" "不会抛出错误，而是将无效的 UTF-16 码点替换为 Unicode 替换字符。" #: :113 #, safe-html, strict-same msgid "When enabling comment support take extra care not to drop whitespace" msgstr "启用注释支持时，需格外注意不要丢失空白字符于" #: :114 #, safe-html, strict-same msgid "" "when reading the input. For example, `std::getline` removes the endline " "characters from the string it produces." msgstr "读取输入时。 例如，`std::getline`会从它生成的字符串中移除行尾字符" #: :117 #, safe-html, strict-same msgid "Full Precision Number Parsing" msgstr "全精度数字解析" #: :118 #, safe-html, strict-same msgid "" "The default algorithm that the library uses to parse numbers is fast, but " "may result in slight precision loss. This may not be suitable for some " "applications, so there is an option to enable an alternative algorithm that " "doesn't have that flaw, but is somewhat slower. To do this, you also need to " "use <> structure." msgstr "" "库默认使用的数字解析算法速度较快，但可能导致轻微的精度损失。这在某些应用中可" "能不可接受，因此可以选择启用一种没有此缺陷但速度稍慢的替代算法。为此，您还需" "要使用<>结构体。" #: :129 #, safe-html, strict-same msgid "" "Note that full precision number parsing requires the algorithm to see the " "full number. This means, that when used with <>, " "additional memory allocations may be necessary to store the number parts " "which were so far accepted by the parser. The library does try its best to " "avoid such allocations." msgstr "" "请注意，全精度数字解析要求算法看到完整的数字。这意味着，当" "与<>一起使用时，可能需要额外的内存分配来存储解析器迄" "今为止接受的数字部分。该库尽力避免此类分配。" #: :135 #, safe-html, strict-same msgid "Parser" msgstr "解析器" #: :136 #, safe-html, strict-same msgid "" "Instances of <> and <> offer functionality " "beyond what is available when using the <> free functions:" msgstr "" "<> 和 <> 的实例所提供的功能超出了" "使用 <> 自由函数时可用的功能：" #: :139 #, safe-html, strict-same msgid "More control over memory" msgstr "对内存的更精细控制" #: :140 #, safe-html, strict-same msgid "Streaming API, parse input JSON incrementally" msgstr "流式 API，可增量解析输入的 JSON" #: :141 #, safe-html, strict-same msgid "Improved performance when parsing multiple JSON texts" msgstr "在解析多个JSON文本时性能更佳" #: :142 #, safe-html, strict-same msgid "Ignore non-JSON content after the end of a JSON text" msgstr "忽略JSON文本末尾之后的非JSON内容" #: :144 #, safe-html, strict-same msgid "" "The parser implementation uses temporary storage space to accumulate values " "during parsing. When using the <> free functions, this storage is " "allocated and freed in each call. However, by declaring an instance of " "<> or <>, this temporary storage can be " "reused when parsing more than one JSON text, reducing the total number of " "dynamic memory allocations." msgstr "" "解析器实现使用临时存储空间在解析过程中累积值。使用 <> 自由函" "数时，该存储在每次调用中都会被分配和释放。然而，通过声明一个 <" "> 或 <> 实例，可在解析多个 JSON 文本时重用该临时" "存储，从而减少动态内存分配的总次数。" #: :151 #, safe-html, strict-same msgid "" "To use the <>, declare an instance. Then call " "<> once with the buffer containing representing the input " "JSON. Finally, call <> to take ownership of the " "resulting <> upon success. This example persists the parser " "instance in a class member to reuse across calls:" msgstr "" "要使用 <>，先声明一个实例。然后调用 <" "> 一次，传入包含输入 JSON 的缓冲区。最后，在成功时调用 " "<> 以获取生成的 <> 的所有权。以下" "示例将解析器实例作为类成员保存，以便在多次调用间复用：" #: :162 #, safe-html, strict-same msgid "" "Sometimes a protocol may have a JSON text followed by data that is in a " "different format or specification. The JSON portion can still be parsed by " "using the function <>. Upon success, the return value " "will indicate the number of characters consumed from the input, which will " "exclude the non-JSON characters:" msgstr "" "有时，某个协议可能在 JSON 文本之后跟随采用不同格式或规范的数据。此时仍可使用" "函数 <> 来解析 JSON 部分。成功时，其返回值将指示" "从输入中消耗的字符数，该数量不包括非 JSON 的字符：" #: :173 #, safe-html, strict-same msgid "" "The parser instance may be constructed with parse options which allow some " "non-standard JSON extensions to be recognized:" msgstr "解析器实例可以使用解析选项构造，这些选项允许识别一些非标准JSON扩展：" #: :181 #, safe-html, strict-same msgid "Streaming Parser" msgstr "流式解析器" #: :182 #, safe-html, strict-same msgid "" "The <> implements a https://en.wikipedia.org/wiki/" "Online_algorithm[__streaming algorithm__]; it allows incremental processing " "of large JSON inputs using one or more contiguous character buffers. The " "entire input JSON does not need to be loaded into memory at once. A network " "server can use the streaming interface to process incoming JSON in fixed-" "size amounts, providing these benefits:" msgstr "" "<>实现了一种https://en.wikipedia.org/wiki/" "Online_algorithm[__流式算法__]；它允许使用一个或多个连续字符缓冲区增量处理大" "型JSON输入。整个输入JSON无需一次性加载到内存中。网络服务器可以使用流式接口以" "固定大小的量处理传入的JSON，从而提供以下优势：" #: :189 #, safe-html, strict-same msgid "CPU consumption per I/O cycle is bounded" msgstr "每个 I/O 周期的 CPU 消耗是有上限的" #: :190 #, safe-html, strict-same msgid "Memory consumption per I/O cycle is bounded" msgstr "每个 I/O 周期的内存消耗是有上限的" #: :191 #, safe-html, strict-same msgid "Jitter, unfairness, and latency is reduced" msgstr "减少抖动、不公平性和延迟" #: :192 #, safe-html, strict-same msgid "Less total memory is required to process the full input" msgstr "处理完整输入所需的总内存更少" #: :194 #, safe-html, strict-same msgid "" "To use the <>, declare an instance. Then call " "<> zero or more times with successive buffers " "representing the input JSON. When there are no more buffers, call " "<>. The function <> " "returns `true` after a successful call to `write` or `finish` if parsing is " "complete." msgstr "" "要使用 <>，请先声明一个实例。然后对表示输入 JSON 的" "连续缓冲区零次或多次调用 <>。当没有更多缓冲区" "时，调用 <>。在成功调用`write`或`finish`后，" "若解析已完成，函数 <> 将返回`true`。" "" #: :200 #, safe-html, strict-same msgid "" "In the following example a JSON text is parsed from standard input a line at " "a time. Error codes are used instead. The function " "<> is used to indicate the end of the input:" msgstr "" "在以下示例中，JSON文本从标准输入逐行解析。此处使用错误码替代异常。函" "数<>用于指示输入结束：" #: :204 #, safe-html, strict-same msgid "This example will break, if comments are enabled, because of" msgstr "如果启用了注释，此示例将失效，原因" #: :205 #, safe-html, strict-same msgid "`std::getline` use (see the warning in <> section)." msgstr "" "在于使用了 `std::getline`（参见 <> 章节中的警告）" "。" #: :212 #, safe-html, strict-same msgid "" "We can complicate the example further by extracting _several_ JSON values " "from the sequence of lines." msgstr "我们可以通过从行序列中提取_多个_JSON值来进一步复杂化此示例。" #: :220 #, safe-html, strict-same msgid "Controlling Memory" msgstr "控制内存" #: :221 #, safe-html, strict-same msgid "" "After default construction, or after <> is called " "with no arguments, the <> produced after a successful parse " "operation uses the default memory resource. To use a different memory " "resource, call `reset` with the resource to use. Here we use a " "<>, which is optimized for parsing but not " "subsequent modification:" msgstr "" "在默认构造之后，或在无参调用 <> 之后，成功解析" "操作所生成的 <> 将使用默认内存资源。若要使用不同的内存资源，" "可调用 `reset`并传入目标资源。以下示例使用了 <" ">，该资源针对解析进行了优化，但不适合后续修改" #: :232 #, safe-html, strict-same msgid "" "To achieve performance and memory efficiency, the parser uses a temporary " "storage area to hold intermediate results. This storage is reused when " "parsing more than one JSON text, reducing the total number of calls to " "allocate memory and thus improving performance. Upon construction, the " "memory resource used to perform allocations for this temporary storage area " "may be specified. Otherwise, the default memory resource is used. In " "addition to a memory resource, the parser can make use of a caller-owned " "buffer for temporary storage. This can help avoid dynamic allocations for " "small inputs. The following example uses a four kilobyte temporary buffer " "for the parser, and falls back to the default memory resource if needed:" msgstr "" "为实现性能与内存效率，解析器使用一块临时存储区来保存中间结果。在解析多个 " "JSON 文本时，该存储区会被复用，从而减少内存分配的总次数，提升性能。构造解析器" "时，可指定用于此临时存储区分配的内存资源；若未指定，则使用默认内存资源。此外" "，解析器还可利用调用方提供的缓冲区作为临时存储，有助于避免对小型输入进行动态" "分配。以下示例为解析器提供了一个 4 KB 的临时缓冲区，并在需要时回退到默认内存" "资源：" #: :248 #, safe-html, strict-same msgid "Avoiding Dynamic Allocations" msgstr "避免动态分配" #: :249 #, safe-html, strict-same msgid "" "Through careful specification of buffers and memory resources, it is " "possible to eliminate all dynamic allocation completely when parsing JSON, " "for the case where the entire JSON text is available in a single character " "buffer, as shown here:" msgstr "" "通过精心指定缓冲区和内存资源，可以在解析 JSON 时完全消除所有动态内存分配，前" "提是整个JSON文本在单个字符缓冲区中可用，如下所示：" #: :259 #, safe-html, strict-same msgid "Custom Parsers" msgstr "自定义解析器" #: :260 #, safe-html, strict-same msgid "" "Users who wish to implement custom parsing strategies may create their own " "handler to use with an instance of <>. The handler " "implements the function signatures required by SAX event interface. In " "<> example we define the \"null\" parser, which throws " "out the parsed results, to use in the implementation of a function that " "determines if a JSON text is valid." msgstr "" "希望实现自定义解析策略的用户可以创建自己的处理器（handler），并与 " "<> 实例配合使用。该处理器需实现 SAX 事件接口所要求的" "函数签名。在 <> 示例中，我们定义了一个“空”解析器（" "null parser），它会丢弃所有解析结果，用于实现一个判断 JSON 文本是否有效的函数" "。"