Boost Json Translation (zh_Hans)/Doc / Pages / Dom / Value (adoc) — Chinese (Simplified Han script) @ Boost-Weblate: However, as shown above these functions throw an exception if …

Zen

Translation

English

Chinese (Simplified Han script)

Needs editing

Skip

Key	English	Chinese (Simplified Han script)
	`std::int64_t`	`std::int64_t`
	A 64 bit signed integer.	64位有符号整数。
:195	<<ref_kind,`kind::uint64`>>	<<ref_kind,`kind::uint64`>></ref_kind,`kind::uint64`>
	`std::uint64_t`	`std::uint64_t`
	A 64 bit unsigned integer.	64位无符号整数。
:195	<<ref_kind,`kind::double_`>>	<<ref_kind,`kind::double_`>></ref_kind,`kind::double_`>
	`double`	`double`
	A `double` holding a floating-point value.	一个`double`，用于保存浮点型值。
:195	<<ref_kind,`kind::bool_`>>	<<ref_kind,`kind::bool_`>></ref_kind,`kind::bool_`>
	https://en.cppreference.com/w/cpp/keyword/bool[`bool`]	https://en.cppreference.com/w/cpp/keyword/bool[`bool`]
	A `bool` holding `true` or `false`.	一个`bool`，用于保存`true`或`false`。
:195	<<ref_kind,`kind::null`>>	<<ref_kind,`kind::null`>></ref_kind,`kind::null`>
	^\| — \| A monostate value representing null. \|===	^\| — \| 一个表示空值的monostate值。 \|===
	The return value from emplace can be used to perform assignment or to capture a reference to the underlying element for later inspection or modification:	置入操作的返回值可用于执行赋值，或捕获对底层元素的引用以供后续检查或修改：
	If the <<ref_kind>> of a <<ref_value>> is known, functions such as <<ref_value_as_bool,`value::as_bool`>> or <<ref_value_as_string,`value::as_string`>> may be used to obtain a reference to the underlying representation without changing the existing value:	如果已知 <<ref_value>> 的 <<ref_kind>>，可使用诸如 <<ref_value_as_bool,`value::as_bool`>> 或 <<ref_value_as_string,`value::as_string`>> 等函数，在不改变现有值的情况下获取对底层表示的引用：</ref_value_as_string,`value::as_string`></ref_value_as_bool,`value::as_bool`></ref_kind></ref_value>
	However, as shown above these functions throw an exception if the kind in the <<ref_value>> does not match the kind denoted by the function signature. This can be used as a concise form of validation: access values as if they were the right type, but handle the resulting exception indicating if the schema of the JSON is not valid.	然而，如上所示，如果 <<ref_value>> 中的实际类型与函数签名所指定的类型不匹配，这些函数会抛出异常。这一行为可作为一种简洁的验证形式：以预期类型直接访问值，若 JSON 结构无效，则通过捕获异常进行处理。</ref_value>
	We can query a value for its underlying representation of a particular kind in a way that does not throw exceptions by requesting a pointer which may be null, instead of a reference. Here we use <<ref_value_if_string,`value::if_string`>> to conditionally perform an assignment without using exceptions:	我们可以通过请求一个可能为空的指针（而非引用）来查询值中特定种类的底层表示形式，而不会抛出异常。这里我们使用 <<ref_value_if_string,`value::if_string`>> 来条件执行赋值操作，而无需使用异常：</ref_value_if_string,`value::if_string`>
	Functions returning {ref_result} allow you to use both approaches:	返回 {ref_result} 的函数允许您同时使用上述两种方式：
	Formatted Output	格式化输出
	When a <<ref_value>> is formatted to a {std_ostream}, the result is serialized JSON as if by calling <<ref_serialize>>.	当将 <<ref_value>> 输出到 {std_ostream} 时，其结果等同于调用 <<ref_serialize>> 所生成的序列化 JSON。</ref_serialize></ref_value>

	English	Chinese (Simplified Han script)	Actions
	<<ref_value_as_int64>>	<<ref_value_as_int64>></ref_value_as_int64>
	null: A	空值：一种
	https://en.cppreference.com/w/cpp/utility/variant/monostate[__monostate__] value, equivalent to `nullptr`.	https://en.cppreference.com/w/cpp/utility/variant/monostate[__monostate__]（单态）值，等同于`nullptr`。
	boolean: A boolean: either `true` or `false`.	布尔值：布尔类型，取值为`true`或`false`。
	number: An integral or floating point value.	数值：整型或浮点型值。
	`std::uint64_t`	`std::uint64_t`
	Working With Values	处理值
	A <<ref_value>> constructed from `nullptr` or default constructed represents a null JSON element:	从`nullptr`构造或默认构造的 <<ref_value>> 表示一个空的JSON元素：</ref_value>
	The member function <<ref_value_kind,`value::kind`>> may be used to query the kind stored in the value. Alternatively, member functions like <<ref_value_is_object,`value::is_object`>> <<ref_value_is_number,`value::is_number`>> may be used to check whether or not the value is a particular kind:	成员函数<<ref_value_kind,`value::kind`>>可用于查询值中存储的种类。或者，也可以使用诸如<<ref_value_is_object,`value::is_object`>>、<<ref_value_is_number,`value::is_number`>> 等成员函数来检查值是否为特定种类：</ref_value_is_number,`value::is_number`></ref_value_is_object,`value::is_object`></ref_value_kind,`value::kind`>
	A 64 bit unsigned integer.	64位无符号整数。
	<<ref_value_emplace_double>>	<<ref_value_emplace_double>></ref_value_emplace_double>
	<<ref_value_if_double>>	<<ref_value_if_double>></ref_value_if_double>
	<<ref_value_emplace_int64>>	<<ref_value_emplace_int64>></ref_value_emplace_int64>
	<<ref_value_is_int64>>	<<ref_value_is_int64>></ref_value_is_int64>
	<<ref_value_if_int64>>	<<ref_value_if_int64>></ref_value_if_int64>
	<<ref_value_try_as_int64>>	<<ref_value_try_as_int64>></ref_value_try_as_int64>
	<<ref_value_get_int64>>	<<ref_value_get_int64>></ref_value_get_int64>
	https://en.cppreference.com/w/cpp/types/integer[`std::uint64_t`]	https://en.cppreference.com/w/cpp/types/integer[`std::uint64_t`]
	<<ref_value_get_uint64>>	<<ref_value_get_uint64>></ref_value_get_uint64>
	https://en.cppreference.com/w/cpp/language/types[`double`]	https://en.cppreference.com/w/cpp/language/types[`double`]
	<<ref_value_try_as_double>>	<<ref_value_try_as_double>></ref_value_try_as_double>
	<<ref_value_as_double>>	<<ref_value_as_double>></ref_value_as_double>
	<<ref_value_get_double>>	<<ref_value_get_double>></ref_value_get_double>
	<<ref_value_emplace_bool>>	<<ref_value_emplace_bool>></ref_value_emplace_bool>
	<<ref_value_try_as_bool>>	<<ref_value_try_as_bool>></ref_value_try_as_bool>
	<<ref_value_get_bool>>	<<ref_value_get_bool>></ref_value_get_bool>
	If the <<ref_kind>> of a <<ref_value>> is known, functions such as <<ref_value_as_bool,`value::as_bool`>> or <<ref_value_as_string,`value::as_string`>> may be used to obtain a reference to the underlying representation without changing the existing value:	如果已知 <<ref_value>> 的 <<ref_kind>>，可使用诸如 <<ref_value_as_bool,`value::as_bool`>> 或 <<ref_value_as_string,`value::as_string`>> 等函数，在不改变现有值的情况下获取对底层表示的引用：</ref_value_as_string,`value::as_string`></ref_value_as_bool,`value::as_bool`></ref_kind></ref_value>
	However, as shown above these functions throw an exception if the kind in the <<ref_value>> does not match the kind denoted by the function signature. This can be used as a concise form of validation: access values as if they were the right type, but handle the resulting exception indicating if the schema of the JSON is not valid.	然而，如上所示，如果 <<ref_value>> 中的实际类型与函数签名所指定的类型不匹配，这些函数会抛出异常。这一行为可作为一种简洁的验证形式：以预期类型直接访问值，若 JSON 结构无效，则通过捕获异常进行处理。</ref_value>
	We can query a value for its underlying representation of a particular kind in a way that does not throw exceptions by requesting a pointer which may be null, instead of a reference. Here we use <<ref_value_if_string,`value::if_string`>> to conditionally perform an assignment without using exceptions:	我们可以通过请求一个可能为空的指针（而非引用）来查询值中特定种类的底层表示形式，而不会抛出异常。这里我们使用 <<ref_value_if_string,`value::if_string`>> 来条件执行赋值操作，而无需使用异常：</ref_value_if_string,`value::if_string`>
	Functions returning {ref_result} allow you to use both approaches:	返回 {ref_result} 的函数允许您同时使用上述两种方式：

Loading…

admin

Translation uploaded

English

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

However, as shown above these functions throw an exception if the kind in the <<ref_value>> does not match the kind denoted by the function signature. This can be used as a concise form of validation: access values as if they were the right type, but handle the resulting exception indicating if the schema of the JSON is not valid.然而，如上所示，如果 <<ref_value>> 中的实际类型与函数签名所指定的类型不匹配，这些函数会抛出异常。这一行为可作为一种简洁的验证形式：以预期类型直接访问值，若 JSON 结构无效，则通过捕获异常进行处理。</ref_value>

06/05/2026

admin

String added in the repository

English

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

06/05/2026

Browse all string changes

Things to check

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

42667

Source string location

:234

String age

06/05/2026

Last updated

06/06/2026

Source string age

06/05/2026

Translation file AsciiDoc file

doc/pages/dom/value_zh_Hans.adoc, string 111

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 full stop

Glossary

String information

Flags

Details

Unit identifier

Source string location

String age

Last updated

Source string age

Translation file AsciiDoc file