Exit Zen
5
:43
English
Similar to its standard library counterpart, elements may be accessed directly by their 0-based index with bounds checking using <<ref_array_at>>, or without bounds checking using <<ref_array_operator_lb_rb>>:
166/2090 · 209
5
:21
English
<<default_memory_resource,default resource>>, an implementation-defined instance which always uses the equivalent of global operator new and delete.
152/1480 · 148
5
:21
English
require that <<ref_value>> be declared as a class template, which would impose an additional compilation burden. By avoiding the template, most of the function definitions in the library can be excluded from the headers and emitted in a separate static or dynamic library.
101/2720 · 272
5
:66
English
In this library the types <<ref_array>>, <<ref_object>>, and <<ref_string>> hold JSON arrays, objects, and strings respectively while the type <<ref_value>> is a special variant which can hold any JSON element. Here we construct an empty object and then insert the elements above:
223/2800 · 280
5
:43
English
In such cases, if every element consists of a string followed by a single value, then the enclosing initializer list is interpreted as an <<ref_object>>. Otherwise, it is interpreted as an <<ref_array>>.
123/2030 · 203
6
:42
English
Direct serialization doesn't require any special components and works with the regular <<ref_serializer>> and <<ref_serialize>>.
107/1280 · 128
6
:26
English
All inserted values will use the same {ref_memory_resource} as the container
40/760 · 76
6
:38
English
The overload lets us use `ip_address` with <<ref_try_value_to>>.
76/640 · 64
6
:36
English
This implementation explicitly creates an <<ref_array>> rather than relying on assignment from an initializer list. But the array uses default {ref_memory_resource}, not the one used by `jv`.
108/1910 · 191
6
:52
English
For the complete listing of all available member functions and nested types, see the reference page for <<ref_array>>.
63/1180 · 118
6
:26
English
"Why use <<ref_storage_ptr>> over {ref_polymorphic_allocator}?:: {ref_polymorphic_allocator} treats the memory resource as a reference with respect to ownership. Boost.JSON uses a reference counted smart pointer container to simplify the lifetime management of memory resources. In addition to being reference counted, <<ref_storage_ptr>> can function as an uncounted reference wrapper around a {ref_memory_resource}.
260/4170 · 417
6
:23
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.
38/1490 · 149
6
:76
English
While keys are strings, the mapped type of objects and the element type of arrays is the aforementioned type <<ref_value>> which can hold any JSON element, as seen in the previous assignments. Instead of building the JSON document using a series of function calls, we can build it in one statement using an initializer list:
135/3240 · 324
6
:26
English
which is optimized for parsing without subsequent modification. The <<ref_stream_parser>> object is reused between trials, allowing temporary memory allocated by the implementation to persist and improve performance.
109/2160 · 216
7
:27
English
itself.
6/100 · 7
7
:45
English
If <<ref_try_value_to>> is used with a type, for which there's no `tag_invoke` overload of the form described in this section, but there is one of the form intended for <<ref_value_to>>, then the library still tries to perform the conversion. It uses the throwing overload, and attempts to convert any thrown exception into an {ref_error_code}. Note, though, that such approach will likely be slower then a dedicated overload.
238/4260 · 426
7
:40
English
To avoid creating such temporaries with an incorrect {ref_memory_resource}, using <<ref_value>>'s member functions <<ref_value_emplace_array>>, <<ref_value_emplace_object>>, and <<ref_value_emplace_string>> can be helpful.
267/2220 · 222
7
:87
English
When a <<ref_value>>, <<ref_array>>, or <<ref_object>> is assigned or constructed from an initializer list, the creation of the new value happens only once. This makes initializer lists equally efficient as using the other ways to create a value. The types in this library are first-class, supporting copy and move construction and assignment:
181/3430 · 343
7
:23
English
to a {std_ostream}.
15/190 · 19
7
:59
English
Initializer lists can be used to unambiguously construct or assign an <<ref_object>> or <<ref_array>>:
86/1020 · 102