Exit Zen
45
:182
English
The <<ref_stream_parser>> implements a https://en.wikipedia.org/wiki/Online_algorithm[__streaming algorithm__]; it allows incremental processing of large JSON inputs using one or more contiguous character buffers. The entire input JSON does not need to be loaded into memory at once. A network server can use the streaming interface to process incoming JSON in fixed-size amounts, providing these benefits:
198/4060 · 406
45
:90
English
2.91MB
6/100 · 6
45
:87
English
The result is an <<ref_object>> with described members' names as keys.
52/700 · 70
46
:97
English
`string_view`
13/130 · 13
46
:124
English
The resource to use when constructing values may be specified in calls to <<ref_parse>> as shown here:
58/1020 · 102
46
:87
English
The result is default-constructed and described members are assigned
25/680 · 68
47
:98
English
`memory_resource`, `polymorphic_allocator`
42/420 · 42
48
:99
English
`error_category`, `error_code`, `error_condition`, `system_error`
65/650 · 65
48
:90
English
707KB
5/100 · 5
50
:151
English
A <<ref_static_resource>> constructs from a caller-provided buffer, and satisfies all memory allocation requests from the buffer. Once the buffer is exhausted, subsequent calls to allocate throw the exception `std::bad_alloc`. The resource offers a simple invariant: dynamic heap allocations are never performed.
147/3120 · 312
50
:194
English
To use the <<ref_stream_parser>>, declare an instance. Then call <<ref_stream_parser_write>> zero or more times with successive buffers representing the input JSON. When there are no more buffers, call <<ref_stream_parser_finish>>. The function <<ref_stream_parser_done>> returns `true` after a successful call to `write` or `finish` if parsing is complete.
324/3570 · 357
50
:111
English
a <<ref_string>>, containing its name. Otherwise it's equal to the input value converted to its underlying type. |The result is the described enumerator, corresponding to the input <<ref_string>>.
70/1960 · 196
51
:95
English
https://en.cppreference.com/w/cpp/types/integer[`std::uint64_t`]
64/640 · 64
51
:200
English
In the following example a JSON text is parsed from standard input a line at a time. Error codes are used instead. The function <<ref_stream_parser_finish>> is used to indicate the end of the input:
107/1980 · 198
51
:90
English
1.54MB
6/100 · 6
51
:116
English
Type satisfying <<ref_is_path_like>>.
53/370 · 37
53
:165
English
The function <<ref_get_null_resource>> returns a global instance of the null resource. This resource offers a simple invariant: all calls to allocate will throw the exception `std::bad_alloc`. An instance of the null resource can be used to make parsing guarantee that allocations from the heap are never made. This is explored in more detail in a later section.
162/3620 · 362
53
:205
English
`std::getline` use (see the warning in <<non_standard_json>> section).
80/700 · 70
54
:90
English
147KB
5/100 · 5
55
:172
English
The containers <<ref_array>>, <<ref_object>>, and <<ref_value>> all propagate the memory resource they were constructed with to child elements:
127/1430 · 143