User avatar admin

Translation uploaded
.<<ref_value>> Accessors [%autowidth,cols=8] |=== |Kind |Representation |Emplacement |Kind Test |Pointer Access |`result` Access |Checked Access |Unchecked Access
.<&lt;<ref_value>> Accessors&gt;访问器 [%autowidth, cols=8] |=== |Kind |Representation |Emplacement |Kind Test |Pointer Access |`result` Access |Checked Access |Unchecked Access种类 |表示形式 |置入 |种类测试 |指针访问 |`result`访问 |受检访问 |非受检访问</ref_value>
06/05/2026
User avatar admin

Translation uploaded
The following table shows all of the ways to determine and access the contents of a <<ref_value>>:
The following table shows all of the ways to determine and access the contents of a <<下表列出了所有用于判断和访问 &lt;<ref_value>&gt; 内容的方法：</ref_value>>:
06/05/2026
User avatar admin

Translation uploaded
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.
After a <&lt;<ref_value>> is constructed, its kind can change depending on what is assigned to it, or by calling functions such as <&gt; 构造之后，其类型可根据赋值内容或通过调用&lt;<ref_value_emplace_array,`value::emplace_array`>> or <&gt; 或 &lt;<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.&gt; 等函数来改变。如果赋值成功，即未引发任何异常，则该值将被替换。否则，原值保持不变。所有可能修改值失败的操作均提供强异常安全保证。</ref_value_emplace_bool,`value::emplace_bool`></ref_value_emplace_array,`value::emplace_array`></ref_value>
06/05/2026
User avatar admin

Translation uploaded
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:
Functions like <诸如 &lt;<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:&gt; 的函数在值为对象时返回指向该对象的指针，否则返回空指针。这使得它们既可用于上述的布尔上下文，也可用于赋值或条件表达式中，以捕获指针的值：</ref_value_if_object,`value::if_object`>
06/05/2026
User avatar admin

Translation uploaded
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:
The member function <成员函数&lt;<ref_value_kind,`value::kind`>> may be used to query the kind stored in the value. Alternatively, member functions like <&gt;可用于查询值中存储的种类。或者，也可以使用诸如&lt;<ref_value_is_object,`value::is_object`>&gt;、&lt;<ref_value_is_objectnumber,`value::is_object`>> <<number`>&gt; 等成员函数来检查值是否为特定种类：</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
User avatar admin

Translation uploaded
A <<ref_value>> constructed from `nullptr` or default constructed represents a null JSON element:
A <<ref_value>> constructed from `nullptr` or default constructed represents a null JSON element:从`nullptr`构造或默认构造的 &lt;<ref_value>&gt; 表示一个空的JSON元素：</ref_value>
06/05/2026
User avatar admin

Translation uploaded
Working With Values
Working With Values处理值
06/05/2026
User avatar admin

Translation uploaded
https://en.wikipedia.org/wiki/Associative_array[__associative array__].
https://en.wikipedia.org/wiki/Associative_array[__associative array__].关联数组__]。
06/05/2026
User avatar admin

Translation uploaded
**object**: A collection of name/value pairs, also known as an
**object**: A collection of name/value pairs, also known as an对象**：名称/值对的集合，也称为
06/05/2026
User avatar admin

Translation uploaded
**array**: An ordered list of values, like {std_vector}.
**array**: An ordered list of values, like 数组**：值的有序列表，类似于{std_vector}.。
06/05/2026
User avatar admin

Translation uploaded
similar to {std_string}.
similar to 类似于{std_string}.。
06/05/2026
User avatar admin

Translation uploaded
**string**: A sequence of zero or more Unicode characters,
**string**: A sequence of zero or more Unicode characters,字符串**：由零个或多个Unicode字符组成的序列，
06/05/2026
User avatar admin

Translation uploaded
**number**: An integral or floating point value.
**number**: An integral or floating point value.数值**：整型或浮点型值。
06/05/2026
User avatar admin

Translation uploaded
**boolean**: A boolean: either `true` or `false`.
**boolean**: A boolean: either 布尔值**：布尔类型，取值为`true` or 或`false`.。
06/05/2026
User avatar admin

Translation uploaded
https://en.cppreference.com/w/cpp/utility/variant/monostate[__monostate__] value, equivalent to `nullptr`.
https://en.cppreference.com/w/cpp/utility/variant/monostate[__monostate__] value, equivalent to （单态）值，等同于`nullptr`.。
06/05/2026
User avatar admin

Translation uploaded
**null**: A
**null**: A空值**：一种
06/05/2026
User avatar admin

Translation uploaded
= `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 documents are represented in memory as instances of <文档在内存中表示为&lt;<ref_value>>: a &gt;的实例：一种{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:以及许多分配器感知容器的要求。它在内部实现为一个https://en.wikipedia.org/wiki/Tagged_union[__variant__]（变体），并且可以动态存储六种已定义的JSON值类型中的任意一种：</ref_value>
06/05/2026
User avatar admin

Resource updated
File “doc/pages/dom/value_zh_Hans.adoc” was added. 06/05/2026
User avatar admin

String added in the repository
When a <<ref_value>> is formatted to a {std_ostream}, the result is serialized JSON as if by calling <<ref_serialize>>.
When a <<ref_value>> is formatted to a {std_ostream}, the result is serialized JSON as if by calling <<ref_serialize>>.
06/05/2026
User avatar admin

String added in the repository
Formatted Output
Formatted Output
06/05/2026

Search