122 strings / 2382 words

Translation Key Source string Target string
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
= 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:
= 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:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
= 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:
= 解析 解析是将序列化的JSON文本验证并分解为元素的过程。该库提供以下函数和类型来辅助解析：
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Name
Name
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Name
一个 SAX 推送式解析器实现，它将序列化的 JSON 文本转换为对用户提供的处理器的一系列成员函数调用，从而允许自定义内存中文档的表示行为。
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Description
Description
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Description
描述
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
<<ref_basic_parser>>
<<ref_basic_parser>>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
<<ref_basic_parser>>
&lt;&gt;
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
A SAX push parser implementation which converts a serialized JSON text into
A SAX push parser implementation which converts a serialized JSON text into
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
A SAX push parser implementation which converts a serialized JSON text into
一个 SAX 推送式解析器实现，它将序列化的 JSON 文本转换
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
a series of member function calls to a user provided handler. This allows custom behaviors to be implemented for representing the document in memory.
a series of member function calls to a user provided handler. This allows custom behaviors to be implemented for representing the document in memory.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
a series of member function calls to a user provided handler. This allows custom behaviors to be implemented for representing the document in memory.
为对用户提供的处理器的一系列成员函数调用，从而允许自定义内存中文档的表示行为
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
<<ref_parse_options>>
<<ref_parse_options>>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
<<ref_parse_options>>
&lt;<ref_parse_options>&gt;</ref_parse_options>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
A structure used to select which extensions are enabled during parsing.
A structure used to select which extensions are enabled during parsing.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
A structure used to select which extensions are enabled during parsing.
一种结构，用于选择在解析期间启用哪些扩展。
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
<<ref_parse>>
<<ref_parse>>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
<<ref_parse>>
&lt;<ref_parse>&gt;</ref_parse>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Parse a string containing a complete serialized JSON text, and return
Parse a string containing a complete serialized JSON text, and return
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Parse a string containing a complete serialized JSON text, and return
解析包含完整序列化 JSON 文本的字符串，并返回
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
a <<ref_value>>.
a <<ref_value>>.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
a <<ref_value>>.
一个 &lt;&gt;。
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
<<ref_parser>>
<<ref_parser>>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
<<ref_parser>>
&lt;<ref_parser>&gt;</ref_parser>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
:33
A stateful DOM parser object which may be used to efficiently parse a series
A stateful DOM parser object which may be used to efficiently parse a series
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
:33
A stateful DOM parser object which may be used to efficiently parse a series
一种有状态的 DOM 解析器对象，可用于高效解析
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
of JSON texts each contained in a single contiguous character buffer, returning each result as a <<ref_value>>.
of JSON texts each contained in a single contiguous character buffer, returning each result as a <<ref_value>>.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
of JSON texts each contained in a single contiguous character buffer, returning each result as a <<ref_value>>.
一系列 JSON 文本（每个文本均位于单独的连续字符缓冲区中），并将每个结果作为&lt;<ref_value>&gt;返回。</ref_value>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
<<ref_stream_parser>>
<<ref_stream_parser>>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
<<ref_stream_parser>>
&lt;<ref_stream_parser>&gt;</ref_stream_parser>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
:38
A stateful DOM parser object which may be used to efficiently parse a series
A stateful DOM parser object which may be used to efficiently parse a series
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
:38
A stateful DOM parser object which may be used to efficiently parse a series
一种有状态的DOM解析器对象，可用于高效地增量解析
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
of JSON texts incrementally, returning each result as a <<ref_value>>.
of JSON texts incrementally, returning each result as a <<ref_value>>.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
of JSON texts incrementally, returning each result as a <<ref_value>>.
一系列JSON文本，并将每个结果作为&lt;<ref_value>&gt;返回</ref_value>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
<<ref_value_stack>>
<<ref_value_stack>>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
<<ref_value_stack>>
&lt;<ref_value_stack>&gt;</ref_value_stack>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
A low level building block used for efficiently building a <<ref_value>>. The
A low level building block used for efficiently building a <<ref_value>>. The
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
A low level building block used for efficiently building a <<ref_value>>. The
一种用于高效构建 &lt;<ref_value>&gt; 的低层构建块。</ref_value>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
parsers use this internally, and users may use it to adapt foreign parsers to produce this library's containers. |===
parsers use this internally, and users may use it to adapt foreign parsers to produce this library's containers. |===
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
parsers use this internally, and users may use it to adapt foreign parsers to produce this library's containers. |===
解析器在内部使用它，用户也可以使用它来适配外部解析器以生成此库的容器。|===
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
The <<ref_parse>> function offers a simple interface for converting a serialized JSON text to a <<ref_value>> in a single function call. This overload uses exceptions to indicate errors:
The <<ref_parse>> function offers a simple interface for converting a serialized JSON text to a <<ref_value>> in a single function call. This overload uses exceptions to indicate errors:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
The <<ref_parse>> function offers a simple interface for converting a serialized JSON text to a <<ref_value>> in a single function call. This overload uses exceptions to indicate errors:
&lt;<ref_parse>&gt; 函数提供了一个简单接口，用于在单个函数调用中将序列化的JSON文本转换为&lt;<ref_value>&gt;。此重载使用异常来指示错误：</ref_value></ref_parse>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Alternatively, an {ref_error_code} can be used:
Alternatively, an {ref_error_code} can be used:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Alternatively, an {ref_error_code} can be used:
或者，可以使用{ref_error_code}：
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Even when using error codes, exceptions thrown from the underlying {ref_memory_resource} are still possible:
Even when using error codes, exceptions thrown from the underlying {ref_memory_resource} are still possible:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Even when using error codes, exceptions thrown from the underlying {ref_memory_resource} are still possible:
即使使用错误码，底层 {ref_memory_resource} 仍可能抛出异常：
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
The <<ref_value>> returned in the preceding examples use the <<default_memory_resource,default memory resource>>. The following code uses a <<ref_monotonic_resource>>, which results in faster parsing. `jv` is marked `const` to prevent subsequent modification, because containers using a monotonic resource waste memory when mutated.
The <<ref_value>> returned in the preceding examples use the <<default_memory_resource,default memory resource>>. The following code uses a <<ref_monotonic_resource>>, which results in faster parsing. `jv` is marked `const` to prevent subsequent modification, because containers using a monotonic resource waste memory when mutated.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
The <<ref_value>> returned in the preceding examples use the <<default_memory_resource,default memory resource>>. The following code uses a <<ref_monotonic_resource>>, which results in faster parsing. `jv` is marked `const` to prevent subsequent modification, because containers using a monotonic resource waste memory when mutated.
前述示例中返回的 &lt;<ref_value>&gt; 使用了 &lt;<default_memory_resource,default memory="" resource="">&gt;（默认内存资源）。以下代码使用了 &lt;<ref_monotonic_resource>&gt;，从而实现更快的解析。`jv` 被标记为 `const` 以防止后续修改，因为使用单调内存资源的容器在被修改时会浪费内存。</ref_monotonic_resource></default_memory_resource,default></ref_value>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Non-Standard JSON
Non-Standard JSON
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Non-Standard JSON
非标准JSON
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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 <<ref_parse_options>> structure and passing it by value. By default all extensions are disabled:
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 <<ref_parse_options>> structure and passing it by value. By default all extensions are disabled:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
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 <<ref_parse_options>> structure and passing it by value. By default all extensions are disabled:
除非另有说明，本库中的解析器采用严格模式，仅识别有效的标准 JSON。通过填充一个 &lt;<ref_parse_options>&gt; 结构并按值传递它来配置解析器，以允许某些非标准扩展。默认情况下，所有扩展都被禁用：</ref_parse_options>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
When building with {cpp}20 or later, the use of https://en.cppreference.com/w/cpp/language/aggregate_initialization#Designated_initializers[designated initializers] with <<ref_parse_options>> is possible:
When building with {cpp}20 or later, the use of https://en.cppreference.com/w/cpp/language/aggregate_initialization#Designated_initializers[designated initializers] with <<ref_parse_options>> is possible:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
When building with {cpp}20 or later, the use of https://en.cppreference.com/w/cpp/language/aggregate_initialization#Designated_initializers[designated initializers] with <<ref_parse_options>> is possible:
当使用 {cpp}20 或更高版本构建时，可以对 &lt;<ref_parse_options>&gt; 使用 https://en.cppreference.com/w/cpp/language/aggregate_initialization#Designated_initializers[指定初始化器]：</ref_parse_options>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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.
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.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
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.
启用 allow_invalid_utf16 后，解析器在遇到非法的前导代理、尾随代理或半个代理时不会抛出错误，而是将无效的 UTF-16 码点替换为 Unicode 替换字符。
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
When enabling comment support take extra care not to drop whitespace
When enabling comment support take extra care not to drop whitespace
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
When enabling comment support take extra care not to drop whitespace
启用注释支持时，需格外注意不要丢失空白字符于
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
when reading the input. For example, `std::getline` removes the endline characters from the string it produces.
when reading the input. For example, `std::getline` removes the endline characters from the string it produces.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
when reading the input. For example, `std::getline` removes the endline characters from the string it produces.
读取输入时。 例如，`std::getline`会从它生成的字符串中移除行尾字符
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Full Precision Number Parsing
Full Precision Number Parsing
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Full Precision Number Parsing
全精度数字解析
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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 <<ref_parse_options>> structure.
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 <<ref_parse_options>> structure.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
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 <<ref_parse_options>> structure.
库默认使用的数字解析算法速度较快，但可能导致轻微的精度损失。这在某些应用中可能不可接受，因此可以选择启用一种没有此缺陷但速度稍慢的替代算法。为此，您还需要使用&lt;<ref_parse_options>&gt;结构体。</ref_parse_options>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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 store the number parts which were so far accepted by the parser. The library does try its best to avoid such allocations.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
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.
请注意，全精度数字解析要求算法看到完整的数字。这意味着，当与&lt;<ref_stream_parser>&gt;一起使用时，可能需要额外的内存分配来存储解析器迄今为止接受的数字部分。该库尽力避免此类分配。</ref_stream_parser>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Parser
Parser
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Parser
解析器
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Instances of <<ref_parser>> and <<ref_stream_parser>> offer functionality beyond what is available when using the <<ref_parse>> free functions:
Instances of <<ref_parser>> and <<ref_stream_parser>> offer functionality beyond what is available when using the <<ref_parse>> free functions:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Instances of <<ref_parser>> and <<ref_stream_parser>> offer functionality beyond what is available when using the <<ref_parse>> free functions:
&lt;<ref_parser>&gt; 和 &lt;<ref_stream_parser>&gt; 的实例所提供的功能超出了使用 &lt;<ref_parse>&gt; 自由函数时可用的功能：</ref_parse></ref_stream_parser></ref_parser>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
More control over memory
More control over memory
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
More control over memory
对内存的更精细控制
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Streaming API, parse input JSON incrementally
Streaming API, parse input JSON incrementally
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Streaming API, parse input JSON incrementally
流式 API，可增量解析输入的 JSON
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Improved performance when parsing multiple JSON texts
Improved performance when parsing multiple JSON texts
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Improved performance when parsing multiple JSON texts
在解析多个JSON文本时性能更佳
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Ignore non-JSON content after the end of a JSON text
Ignore non-JSON content after the end of a JSON text
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Ignore non-JSON content after the end of a JSON text
忽略JSON文本末尾之后的非JSON内容
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
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>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
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>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
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>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
The parser instance may be constructed with parse options which allow some non-standard JSON extensions to be recognized:
解析器实例可以使用解析选项构造，这些选项允许识别一些非标准JSON扩展：
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Streaming Parser
Streaming Parser
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Streaming Parser
流式解析器
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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 <<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:
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
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:
&lt;<ref_stream_parser>&gt;实现了一种https://en.wikipedia.org/wiki/Online_algorithm[__流式算法__]；它允许使用一个或多个连续字符缓冲区增量处理大型JSON输入。整个输入JSON无需一次性加载到内存中。网络服务器可以使用流式接口以固定大小的量处理传入的JSON，从而提供以下优势：</ref_stream_parser>
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
CPU consumption per I/O cycle is bounded
CPU consumption per I/O cycle is bounded
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
CPU consumption per I/O cycle is bounded
每个 I/O 周期的 CPU 消耗是有上限的
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Memory consumption per I/O cycle is bounded
Memory consumption per I/O cycle is bounded
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Memory consumption per I/O cycle is bounded
每个 I/O 周期的内存消耗是有上限的
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Jitter, unfairness, and latency is reduced
Jitter, unfairness, and latency is reduced
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Jitter, unfairness, and latency is reduced
减少抖动、不公平性和延迟
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
Less total memory is required to process the full input
Less total memory is required to process the full input
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
Less total memory is required to process the full input
处理完整输入所需的总内存更少
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — English
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 <<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.
Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script)
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.
要使用 &lt;<ref_stream_parser>&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>