User avatar admin

Translation uploaded
This example will break, if comments are enabled, because of
This example will break, if comments are enabled, because of如果启用了注释，此示例将失效，原因
06/05/2026
User avatar admin

Translation uploaded
In the following example a JSON text is parsed from standard input a line at a time. Error codes are used instead. The function <<ref_stream_parser_finish>> is used to indicate the end of the input:
In the following example a JSON text is parsed from standard input a line at a time. Error codes are used instead. The function <<ref_stream_parser_finish>> is used to indicate the end of the input:在以下示例中，JSON文本从标准输入逐行解析。此处使用错误码替代异常。函数&lt;<ref_stream_parser_finish>&gt;用于指示输入结束：</ref_stream_parser_finish>
06/05/2026
User avatar admin

Translation uploaded
To use the <<ref_stream_parser>>, declare an instance. Then call <<ref_stream_parser_write>> zero or more times with successive buffers representing the input JSON. When there are no more buffers, call <<ref_stream_parser_finish>>. The function <<ref_stream_parser_done>> returns `true` after a successful call to `write` or `finish` if parsing is complete.
To use the <要使用 &lt;<ref_stream_parser>>, declare an instance. Then call <<ref_stream_parser_write>> zero or more times with successive buffers representing the input JSON. When there are no more buffers, call <<ref_stream_parser_finish>>. The function <<ref_stream_parser_done>> returns `true` after a successful call to `write` or `finish` if parsing is complete.&gt;，请先声明一个实例。然后对表示输入 JSON 的连续缓冲区零次或多次调用 &lt;<ref_stream_parser_write>&gt;。当没有更多缓冲区时，调用 &lt;<ref_stream_parser_finish>&gt;。在成功调用`write`或`finish`后，若解析已完成，函数 &lt;<ref_stream_parser_done>&gt; 将返回`true`。</ref_stream_parser_done></ref_stream_parser_finish></ref_stream_parser_write></ref_stream_parser>
06/05/2026
User avatar admin

Translation uploaded
Less total memory is required to process the full input
Less total memory is required to process the full input处理完整输入所需的总内存更少
06/05/2026
User avatar admin

Translation uploaded
Jitter, unfairness, and latency is reduced
Jitter, unfairness, and latency is reduced减少抖动、不公平性和延迟
06/05/2026
User avatar admin

Translation uploaded
Memory consumption per I/O cycle is bounded
Memory consumption per I/O cycle is bounded每个 I/O 周期的内存消耗是有上限的
06/05/2026
User avatar admin

Translation uploaded
CPU consumption per I/O cycle is bounded
CPU consumption per I/O cycle is bounded每个 I/O 周期的 CPU 消耗是有上限的
06/05/2026
User avatar admin

Translation uploaded
The <<ref_stream_parser>> 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:
The <&lt;<ref_stream_parser>> implements a &gt;实现了一种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:流式算法__]；它允许使用一个或多个连续字符缓冲区增量处理大型JSON输入。整个输入JSON无需一次性加载到内存中。网络服务器可以使用流式接口以固定大小的量处理传入的JSON，从而提供以下优势：</ref_stream_parser>
06/05/2026
User avatar admin

Translation uploaded
Streaming Parser
Streaming Parser流式解析器
06/05/2026
User avatar admin

Translation uploaded
The parser instance may be constructed with parse options which allow some non-standard JSON extensions to be recognized:
The parser instance may be constructed with parse options which allow some non-standard JSON extensions to be recognized:解析器实例可以使用解析选项构造，这些选项允许识别一些非标准JSON扩展：
06/05/2026
User avatar admin

Translation uploaded
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 <<ref_parser_write_some>>. Upon success, the return value will indicate the number of characters consumed from the input, which will exclude the non-JSON characters:
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 <<ref_parser_write_some>>. Upon success, the return value will indicate the number of characters consumed from the input, which will exclude the non-JSON characters:有时，某个协议可能在 JSON 文本之后跟随采用不同格式或规范的数据。此时仍可使用函数 &lt;<ref_parser_write_some>&gt; 来解析 JSON 部分。成功时，其返回值将指示从输入中消耗的字符数，该数量不包括非 JSON 的字符：</ref_parser_write_some>
06/05/2026
User avatar admin

Translation uploaded
To use the <<ref_parser>>, declare an instance. Then call <<ref_parser_write>> once with the buffer containing representing the input JSON. Finally, call <<ref_parser_release>> to take ownership of the resulting <<ref_value>> upon success. This example persists the parser instance in a class member to reuse across calls:
To use the <<ref_parser>>, declare an instance. Then call <<ref_parser_write>> once with the buffer containing representing the input JSON. Finally, call <<ref_parser_release>> to take ownership of the resulting <<ref_value>> upon success. This example persists the parser instance in a class member to reuse across calls:要使用 &lt;<ref_parser>&gt;，先声明一个实例。然后调用 &lt;<ref_parser_write>&gt; 一次，传入包含输入 JSON 的缓冲区。最后，在成功时调用 &lt;<ref_parser_release>&gt; 以获取生成的 &lt;<ref_value>&gt; 的所有权。以下示例将解析器实例作为类成员保存，以便在多次调用间复用：</ref_value></ref_parser_release></ref_parser_write></ref_parser>
06/05/2026
User avatar admin

Translation uploaded
The parser implementation uses temporary storage space to accumulate values during parsing. When using the <<ref_parse>> free functions, this storage is allocated and freed in each call. However, by declaring an instance of <<ref_parser>> or <<ref_stream_parser>>, this temporary storage can be reused when parsing more than one JSON text, reducing the total number of dynamic memory allocations.
The parser implementation uses temporary storage space to accumulate values during parsing. When using the <<ref_parse>> free functions, this storage is allocated and freed in each call. However, by declaring an instance of <<ref_parser>> or <<ref_stream_parser>>, this temporary storage can be reused when parsing more than one JSON text, reducing the total number of dynamic memory allocations.解析器实现使用临时存储空间在解析过程中累积值。使用 &lt;<ref_parse>&gt; 自由函数时，该存储在每次调用中都会被分配和释放。然而，通过声明一个 &lt;<ref_parser>&gt; 或 &lt;<ref_stream_parser>&gt; 实例，可在解析多个 JSON 文本时重用该临时存储，从而减少动态内存分配的总次数。</ref_stream_parser></ref_parser></ref_parse>
06/05/2026
User avatar admin

Translation uploaded
Ignore non-JSON content after the end of a JSON text
Ignore non-JSON content after the end of a JSON text忽略JSON文本末尾之后的非JSON内容
06/05/2026
User avatar admin

Translation uploaded
Improved performance when parsing multiple JSON texts
Improved performance when parsing multiple JSON texts在解析多个JSON文本时性能更佳
06/05/2026
User avatar admin

Translation uploaded
Streaming API, parse input JSON incrementally
Streaming API, parse input JSON incrementally流式 API，可增量解析输入的 JSON
06/05/2026
User avatar admin

Translation uploaded
More control over memory
More control over memory对内存的更精细控制
06/05/2026
User avatar admin

Translation uploaded
Instances of <<ref_parser>> and <<ref_stream_parser>> offer functionality beyond what is available when using the <<ref_parse>> free functions:
Instances of <&lt;<ref_parser>> and <&gt; 和 &lt;<ref_stream_parser>> offer functionality beyond what is available when using the <<ref_parse>> free functions:&gt; 的实例所提供的功能超出了使用 &lt;<ref_parse>&gt; 自由函数时可用的功能：</ref_parse></ref_stream_parser></ref_parser>
06/05/2026
User avatar admin

Translation uploaded
Parser
Parser解析器
06/05/2026
User avatar admin

Translation uploaded
Note that full precision number parsing requires the algorithm to see the full number. This means, that when used with <<ref_stream_parser>>, 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.
Note that full precision number parsing requires the algorithm to see the full number. This means, that when used with <<ref_stream_parser>>, additional memory allocations may be necessary to 请注意，全精度数字解析要求算法看到完整的数字。这意味着，当与&lt;<ref_stream_parser>&gt;一起使用时，可能需要额外的内存分配来存储解析器迄今为止接受的数字部分。该库尽力避免此类分配。</ref_store the number parts which were so far accepted by the parser. The library does try its best to avoid such allocations.am_parser>
06/05/2026

Search