User avatar admin

String added in the repository
<<ref_operator_lt_lt>>
<<ref_operator_lt_lt>>
06/05/2026
User avatar admin

String added in the repository
Description
Description
06/05/2026
User avatar admin

String added in the repository
Name
Name
06/05/2026
User avatar admin

String added in the repository
Serialization is the process where a JSON document represented in memory by a <<ref_value>> is turned into a sequence of characters. The library provides the following free functions and types for serialization:
Serialization is the process where a JSON document represented in memory by a <<ref_value>> is turned into a sequence of characters. The library provides the following free functions and types for serialization:
06/05/2026
User avatar admin

String added in the repository
= Serializing
= Serializing
06/05/2026
User avatar admin

Resource updated
Parsing of the “doc/pages/io/parsing.adoc” file was enforced. 06/05/2026
User avatar admin

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

String added in the repository
Users who wish to implement custom parsing strategies may create their own handler to use with an instance of <<ref_basic_parser>>. The handler implements the function signatures required by SAX event interface. In <<examples_validate>> example we define the "null" parser, which throws out the parsed results, to use in the implementation of a function that determines if a JSON text is valid.
Users who wish to implement custom parsing strategies may create their own handler to use with an instance of <<ref_basic_parser>>. The handler implements the function signatures required by SAX event interface. In <<examples_validate>> example we define the "null" parser, which throws out the parsed results, to use in the implementation of a function that determines if a JSON text is valid.
06/05/2026
User avatar admin

String added in the repository
Custom Parsers
Custom Parsers
06/05/2026
User avatar admin

String added in the repository
Through careful specification of buffers and memory resources, it is possible to eliminate all dynamic allocation completely when parsing JSON, for the case where the entire JSON text is available in a single character buffer, as shown here:
Through careful specification of buffers and memory resources, it is possible to eliminate all dynamic allocation completely when parsing JSON, for the case where the entire JSON text is available in a single character buffer, as shown here:
06/05/2026
User avatar admin

String added in the repository
Avoiding Dynamic Allocations
Avoiding Dynamic Allocations
06/05/2026
User avatar admin

String added in the repository
To achieve performance and memory efficiency, the parser uses a temporary storage area to hold intermediate results. This storage is reused when parsing more than one JSON text, reducing the total number of calls to allocate memory and thus improving performance. Upon construction, the memory resource used to perform allocations for this temporary storage area may be specified. Otherwise, the default memory resource is used. In addition to a memory resource, the parser can make use of a caller-owned buffer for temporary storage. This can help avoid dynamic allocations for small inputs. The following example uses a four kilobyte temporary buffer for the parser, and falls back to the default memory resource if needed:
To achieve performance and memory efficiency, the parser uses a temporary storage area to hold intermediate results. This storage is reused when parsing more than one JSON text, reducing the total number of calls to allocate memory and thus improving performance. Upon construction, the memory resource used to perform allocations for this temporary storage area may be specified. Otherwise, the default memory resource is used. In addition to a memory resource, the parser can make use of a caller-owned buffer for temporary storage. This can help avoid dynamic allocations for small inputs. The following example uses a four kilobyte temporary buffer for the parser, and falls back to the default memory resource if needed:
06/05/2026
User avatar admin

String added in the repository
After default construction, or after <<ref_stream_parser_reset>> is called with no arguments, the <<ref_value>> produced after a successful parse operation uses the default memory resource. To use a different memory resource, call `reset` with the resource to use. Here we use a <<ref_monotonic_resource>>, which is optimized for parsing but not subsequent modification:
After default construction, or after <<ref_stream_parser_reset>> is called with no arguments, the <<ref_value>> produced after a successful parse operation uses the default memory resource. To use a different memory resource, call `reset` with the resource to use. Here we use a <<ref_monotonic_resource>>, which is optimized for parsing but not subsequent modification:
06/05/2026
User avatar admin

String added in the repository
Controlling Memory
Controlling Memory
06/05/2026
User avatar admin

String added in the repository
We can complicate the example further by extracting _several_ JSON values from the sequence of lines.
We can complicate the example further by extracting _several_ JSON values from the sequence of lines.
06/05/2026
User avatar admin

String added in the repository
`std::getline` use (see the warning in <<non_standard_json>> section).
`std::getline` use (see the warning in <<non_standard_json>> section).
06/05/2026
User avatar admin

String added in the repository
This example will break, if comments are enabled, because of
This example will break, if comments are enabled, because of
06/05/2026
User avatar admin

String added in the repository
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:
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:
06/05/2026
User avatar admin

String added in the repository
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.
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.
06/05/2026
User avatar admin

String added in the repository
Less total memory is required to process the full input
Less total memory is required to process the full input
06/05/2026

Search