Boost Json Translation (zh_Hans)/Doc / Pages / Dom / Value (adoc) — Chinese (Simplified Han script) @ Boost-Weblate: The member function <<ref_value_kind,`value::kind`>> may be used to query the …

Zen

Translation

English

Chinese (Simplified Han script)

Needs editing

Skip

Key	English	Chinese (Simplified Han script)
	= `value` JSON documents are represented in memory as instances of <<ref_value>>: a {req_Regular} type which satisfies {req_DefaultConstructible}, {req_CopyConstructible}, {req_CopyAssignable}, {req_MoveConstructible}, {req_MoveAssignable}, and many of the requirements of allocator-aware containers. It is implemented as a https://en.wikipedia.org/wiki/Tagged_union[__variant__] internally, and can dynamically store any of the six defined JSON value types:	= `value` JSON文档在内存中表示为<<ref_value>>的实例：一种{req_Regular}类型，满足{req_DefaultConstructible}、{req_CopyConstructible}、{req_CopyAssignable}、{req_MoveConstructible}、{req_MoveAssignable}以及许多分配器感知容器的要求。它在内部实现为一个https://en.wikipedia.org/wiki/Tagged_union[__variant__]（变体），并且可以动态存储六种已定义的JSON值类型中的任意一种：</ref_value>
	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.	数值：整型或浮点型值。
	string: A sequence of zero or more Unicode characters,	字符串：由零个或多个Unicode字符组成的序列，
	similar to {std_string}.	类似于{std_string}。
	array: An ordered list of values, like {std_vector}.	数组：值的有序列表，类似于{std_vector}。
	object: A collection of name/value pairs, also known as an	对象：名称/值对的集合，也称为
	https://en.wikipedia.org/wiki/Associative_array[__associative array__].	https://en.wikipedia.org/wiki/Associative_array[__关联数组__]。
	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`>
	Functions like <<ref_value_if_object,`value::if_object`>> actually return a pointer to the object if the value is an object, otherwise they return null. This allows them to be used both in boolean contexts as above, and in assignments or conditional expressions to capture the value of the pointer:	诸如 <<ref_value_if_object,`value::if_object`>> 的函数在值为对象时返回指向该对象的指针，否则返回空指针。这使得它们既可用于上述的布尔上下文，也可用于赋值或条件表达式中，以捕获指针的值：</ref_value_if_object,`value::if_object`>
	After a <<ref_value>> is constructed, its kind can change depending on what is assigned to it, or by calling functions such as <<ref_value_emplace_array,`value::emplace_array`>> or <<ref_value_emplace_bool,`value::emplace_bool`>>. If the assignment is successful, in other words it completes without any exceptions then the value is replaced. Otherwise, the value is unchanged. All operations which can fail to modify a value offer the strong exception safety guarantee.	<<ref_value>> 构造之后，其类型可根据赋值内容或通过调用<<ref_value_emplace_array,`value::emplace_array`>> 或 <<ref_value_emplace_bool,`value::emplace_bool`>> 等函数来改变。如果赋值成功，即未引发任何异常，则该值将被替换。否则，原值保持不变。所有可能修改值失败的操作均提供强异常安全保证。</ref_value_emplace_bool,`value::emplace_bool`></ref_value_emplace_array,`value::emplace_array`></ref_value>
	The following table shows all of the ways to determine and access the contents of a <<ref_value>>:	下表列出了所有用于判断和访问 <<ref_value>> 内容的方法：</ref_value>
	.<<ref_value>> Accessors [%autowidth,cols=8] \|=== \|Kind \|Representation \|Emplacement \|Kind Test \|Pointer Access \|`result` Access \|Checked Access \|Unchecked Access	.<<ref_value>>访问器 [%autowidth, cols=8] \|=== \|种类 \|表示形式 \|置入 \|种类测试 \|指针访问 \|`result`访问 \|受检访问 \|非受检访问</ref_value>
:95	<<ref_kind,`kind::array`>>	<<ref_kind,`kind::array`>></ref_kind,`kind::array`>
:95	<<ref_array>>	<<ref_array>></ref_array>
	<<ref_value_emplace_array>>	<<ref_value_emplace_array>></ref_value_emplace_array>
	<<ref_value_is_array>>	<<ref_value_is_array>></ref_value_is_array>
	<<ref_value_if_array>>	<<ref_value_if_array>></ref_value_if_array>
	<<ref_value_try_as_array>>	<<ref_value_try_as_array>></ref_value_try_as_array>
	<<ref_value_as_array>>	<<ref_value_as_array>></ref_value_as_array>
	<<ref_value_get_array>>	<<ref_value_get_array>></ref_value_get_array>
:95	<<ref_kind,`kind::object`>>	<<ref_kind,`kind::object`>></ref_kind,`kind::object`>
:95	<<ref_object>>	<<ref_object>></ref_object>
	<<ref_value_emplace_object>>	<<ref_value_emplace_object>></ref_value_emplace_object>

	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_uint64>>	<<ref_value_emplace_uint64>></ref_value_emplace_uint64>
	<<ref_value_is_uint64>>	<<ref_value_is_uint64>></ref_value_is_uint64>
	<<ref_value_if_bool>>	<<ref_value_if_bool>></ref_value_if_bool>
	<<ref_value_as_bool>>	<<ref_value_as_bool>></ref_value_as_bool>
	<<ref_value_is_array>>	<<ref_value_is_array>></ref_value_is_array>
	<<ref_value_emplace_object>>	<<ref_value_emplace_object>></ref_value_emplace_object>
	<<ref_value_as_object>>	<<ref_value_as_object>></ref_value_as_object>
	<<ref_value_get_object>>	<<ref_value_get_object>></ref_value_get_object>
	<<ref_value_try_as_string>>	<<ref_value_try_as_string>></ref_value_try_as_string>
	<<ref_value_if_uint64>>	<<ref_value_if_uint64>></ref_value_if_uint64>
	<<ref_value_is_double>>	<<ref_value_is_double>></ref_value_is_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) 191 characters editedCurrent translationState: Translated

~~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_~~object~~number,`value::is_~~object`>> <<~~number`>> 等成员函数来检查值是否为特定种类：</ref_value_is_number,`value::is_number`>~~> may be used to check whether or not the value is a particular~~ </ref_value_is_object,`value::is_object`></ref_value_kind,`value::kind:`>

06/05/2026

admin

String added in the repository

English

Chinese (Simplified Han script) 294 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

Mismatched colon

Source and translation do not both end with a colon.

Reset

Glossary

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

String information

Flags

safe-html, strict-same

Unit identifier

42569

Source string location

:46

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 13

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

Mismatched colon

Glossary

String information

Flags

Details

Unit identifier

Source string location

String age

Last updated

Source string age

Translation file AsciiDoc file