Boost Json Translation (zh_Hans)/Doc / Pages / Io / Parsing (adoc) — Chinese (Simplified Han script) @ Boost-Weblate: The <<ref_parse>> function offers a simple interface for converting a …

Zen

Translation

English

Chinese (Simplified Han script)

Needs editing

Skip

Key	English	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.	为对用户提供的处理器的一系列成员函数调用，从而允许自定义内存中文档的表示行为
	<<ref_parse_options>>	<<ref_parse_options>></ref_parse_options>
	A structure used to select which extensions are enabled during parsing.	一种结构，用于选择在解析期间启用哪些扩展。
	<<ref_parse>>	<<ref_parse>></ref_parse>
	Parse a string containing a complete serialized JSON text, and return	解析包含完整序列化 JSON 文本的字符串，并返回
	a <<ref_value>>.	一个 <>。
	<<ref_parser>>	<<ref_parser>></ref_parser>
:33	A stateful DOM parser object which may be used to efficiently parse a series	一种有状态的 DOM 解析器对象，可用于高效解析
	of JSON texts each contained in a single contiguous character buffer, returning each result as a <<ref_value>>.	一系列 JSON 文本（每个文本均位于单独的连续字符缓冲区中），并将每个结果作为<<ref_value>>返回。</ref_value>
	<<ref_stream_parser>>	<<ref_stream_parser>></ref_stream_parser>
:38	A stateful DOM parser object which may be used to efficiently parse a series	一种有状态的DOM解析器对象，可用于高效地增量解析
	of JSON texts incrementally, returning each result as a <<ref_value>>.	一系列JSON文本，并将每个结果作为<<ref_value>>返回</ref_value>
	<<ref_value_stack>>	<<ref_value_stack>></ref_value_stack>
	A low level building block used for efficiently building a <<ref_value>>. The	一种用于高效构建 <<ref_value>> 的低层构建块。</ref_value>
	parsers use this internally, and users may use it to adapt foreign parsers to produce this library's containers. \|===	解析器在内部使用它，用户也可以使用它来适配外部解析器以生成此库的容器。\|===
	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:	<<ref_parse>> 函数提供了一个简单接口，用于在单个函数调用中将序列化的JSON文本转换为<<ref_value>>。此重载使用异常来指示错误：</ref_value></ref_parse>
	Alternatively, an {ref_error_code} can be used:	或者，可以使用{ref_error_code}：
	Even when using error codes, exceptions thrown from the underlying {ref_memory_resource} are still possible:	即使使用错误码，底层 {ref_memory_resource} 仍可能抛出异常：
	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.	前述示例中返回的 <<ref_value>> 使用了 <<default_memory_resource,default memory="" resource="">>（默认内存资源）。以下代码使用了 <<ref_monotonic_resource>>，从而实现更快的解析。`jv` 被标记为 `const` 以防止后续修改，因为使用单调内存资源的容器在被修改时会浪费内存。</ref_monotonic_resource></default_memory_resource,default></ref_value>
	Non-Standard JSON	非标准JSON
	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。通过填充一个 <<ref_parse_options>> 结构并按值传递它来配置解析器，以允许某些非标准扩展。默认情况下，所有扩展都被禁用：</ref_parse_options>
	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 或更高版本构建时，可以对 <<ref_parse_options>> 使用 https://en.cppreference.com/w/cpp/language/aggregate_initialization#Designated_initializers[指定初始化器]：</ref_parse_options>
	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 替换字符。
	When enabling comment support take extra care not to drop whitespace	启用注释支持时，需格外注意不要丢失空白字符于
	when reading the input. For example, `std::getline` removes the endline characters from the string it produces.	读取输入时。例如，`std::getline`会从它生成的字符串中移除行尾字符
	Full Precision Number Parsing	全精度数字解析
	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.	库默认使用的数字解析算法速度较快，但可能导致轻微的精度损失。这在某些应用中可能不可接受，因此可以选择启用一种没有此缺陷但速度稍慢的替代算法。为此，您还需要使用<<ref_parse_options>>结构体。</ref_parse_options>
	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.	请注意，全精度数字解析要求算法看到完整的数字。这意味着，当与<<ref_stream_parser>>一起使用时，可能需要额外的内存分配来存储解析器迄今为止接受的数字部分。该库尽力避免此类分配。</ref_stream_parser>
	Parser	解析器
	Instances of <<ref_parser>> and <<ref_stream_parser>> offer functionality beyond what is available when using the <<ref_parse>> free functions:	<<ref_parser>> 和 <<ref_stream_parser>> 的实例所提供的功能超出了使用 <<ref_parse>> 自由函数时可用的功能：</ref_parse></ref_stream_parser></ref_parser>
	More control over memory	对内存的更精细控制

	English	Chinese (Simplified Han script)	Actions
	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.	前述示例中返回的 <<ref_value>> 使用了 <<default_memory_resource,default memory="" resource="">>（默认内存资源）。以下代码使用了 <<ref_monotonic_resource>>，从而实现更快的解析。`jv` 被标记为 `const` 以防止后续修改，因为使用单调内存资源的容器在被修改时会浪费内存。</ref_monotonic_resource></default_memory_resource,default></ref_value>
	Even when using error codes, exceptions thrown from the underlying {ref_memory_resource} are still possible:	即使使用错误码，底层 {ref_memory_resource} 仍可能抛出异常：
	a series of member function calls to a user provided handler. This allows custom behaviors to be implemented for representing the document in memory.	为对用户提供的处理器的一系列成员函数调用，从而允许自定义内存中文档的表示行为
	<<ref_parse_options>>	<<ref_parse_options>></ref_parse_options>
	of JSON texts each contained in a single contiguous character buffer, returning each result as a <<ref_value>>.	一系列 JSON 文本（每个文本均位于单独的连续字符缓冲区中），并将每个结果作为<<ref_value>>返回。</ref_value>
	<<ref_stream_parser>>	<<ref_stream_parser>></ref_stream_parser>
	of JSON texts incrementally, returning each result as a <<ref_value>>.	一系列JSON文本，并将每个结果作为<<ref_value>>返回</ref_value>
	<<ref_value_stack>>	<<ref_value_stack>></ref_value_stack>
	A low level building block used for efficiently building a <<ref_value>>. The	一种用于高效构建 <<ref_value>> 的低层构建块。</ref_value>
	parsers use this internally, and users may use it to adapt foreign parsers to produce this library's containers. \|===	解析器在内部使用它，用户也可以使用它来适配外部解析器以生成此库的容器。\|===
	Name	一个 SAX 推送式解析器实现，它将序列化的 JSON 文本转换为对用户提供的处理器的一系列成员函数调用，从而允许自定义内存中文档的表示行为。
	Description	描述
	<<ref_basic_parser>>	<>
	A SAX push parser implementation which converts a serialized JSON text into	一个 SAX 推送式解析器实现，它将序列化的 JSON 文本转换
	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:	<<ref_parse>> 函数提供了一个简单接口，用于在单个函数调用中将序列化的JSON文本转换为<<ref_value>>。此重载使用异常来指示错误：</ref_value></ref_parse>
	Alternatively, an {ref_error_code} can be used:	或者，可以使用{ref_error_code}：
	Jitter, unfairness, and latency is reduced	减少抖动、不公平性和延迟
	Avoiding Dynamic Allocations	避免动态分配
	= 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文本验证并分解为元素的过程。该库提供以下函数和类型来辅助解析：
	A structure used to select which extensions are enabled during parsing.	一种结构，用于选择在解析期间启用哪些扩展。
	<<ref_parse>>	<<ref_parse>></ref_parse>
	Parse a string containing a complete serialized JSON text, and return	解析包含完整序列化 JSON 文本的字符串，并返回
	a <<ref_value>>.	一个 <>。
	<<ref_parser>>	<<ref_parser>></ref_parser>
	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。通过填充一个 <<ref_parse_options>> 结构并按值传递它来配置解析器，以允许某些非标准扩展。默认情况下，所有扩展都被禁用：</ref_parse_options>
	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 或更高版本构建时，可以对 <<ref_parse_options>> 使用 https://en.cppreference.com/w/cpp/language/aggregate_initialization#Designated_initializers[指定初始化器]：</ref_parse_options>
	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 替换字符。
	When enabling comment support take extra care not to drop whitespace	启用注释支持时，需格外注意不要丢失空白字符于
	when reading the input. For example, `std::getline` removes the endline characters from the string it produces.	读取输入时。例如，`std::getline`会从它生成的字符串中移除行尾字符
	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:	通过精心指定缓冲区和内存资源，可以在解析 JSON 时完全消除所有动态内存分配，前提是整个JSON文本在单个字符缓冲区中可用，如下所示：

Loading…

admin

Translation uploaded

English

Chinese (Simplified Han script) 150 characters editedCurrent translationState: Translated

06/05/2026

admin

String added in the repository

English

Chinese (Simplified Han script) 186 characters editedPrevious translationState: Needs editing (Needs rewriting)

06/05/2026

Browse all string changes

Things to check

Mismatched colon

Source and translation do not both end with a colon.

Reset

Mismatched full stop

Source and translation do not both end with a full stop.

Reset

Glossary

English	Chinese (Simplified Han script)
No related strings found in the glossary.

String information

Flags

safe-html, strict-same

Unit identifier

42832

Source string location

:48

String age

06/05/2026

Last updated

06/06/2026

Source string age

06/05/2026

Translation file AsciiDoc file

doc/pages/io/parsing_zh_Hans.adoc, string 21

Shortcut	Action
`?`	Open available keyboard shortcuts.
`Alt` + `Home`	Navigate to the first translation in the current search.
`Alt` + `End`	Navigate to the last translation in the current search.
`Alt` + `PageUp` or `Ctrl` + `↑` or `Alt` + `↑` or `Cmd` + `↑` or	Navigate to the previous translation in the current search.
`Alt` + `PageDown` or `Ctrl` + `↓` or `Alt` + `↓` or `Cmd` + `↓` or	Navigate to the next translation in the current search.
`Ctrl` + `Enter` or `Cmd` + `Enter`	Submit current form; this works the same as pressing Save and continue while editing translation.
`Ctrl` + `Shift` + `Enter` or `Cmd` + `Shift` +`Enter`	Unmark translation as Needing edit and submit it.
`Alt` + `Enter` or `Option` + `Enter`	Submit the string as a suggestion; this works the same as pressing Suggest while editing translation.
`Ctrl` + `E` or `Cmd` + `E`	Focus on translation editor.
`Ctrl` + `U` or `Cmd` + `U`	Focus on comment editor.
`Ctrl` + `M` or `Cmd` + `M`	Shows Automatic suggestions tab.
`Ctrl` + `1` to `Ctrl` + `9` or `Cmd` + `1` to `Cmd` + `9`	Copies placeable of a given number from source string.
`Ctrl` + `M` followed by `1` to `9` or `Cmd` + `M` followed by `1` to `9`	Copy the machine translation of a given number to current translation.
`Ctrl` + `I` followed by `1` to `9` or `Cmd` + `I` followed by `1` to `9`	Ignore one item in the list of failing checks.
`Ctrl` + `J` or `Cmd` + `J`	Shows the Nearby strings tab.
`Ctrl` + `S` or `Cmd` + `S`	Focus on search field.
`Ctrl` + `O` or `Cmd` + `O`	Copy the source string.
`Ctrl` + `Y` or `Cmd` + `Y`	Toggle the Needs editing checkbox.
`→`	Browse the next translation string.
`←`	Browse the previous translation string.

Translation

Things to check

Mismatched colon

Mismatched full stop

Glossary

String information

Flags

Details

Unit identifier

Source string location

String age

Last updated

Source string age

Translation file AsciiDoc file