![]() |
Home | Libraries | People | FAQ | More |
Return parsed JSON as a value.
Defined in header <boost/json/parse.hpp>
value parse( std::istream& is, storage_ptr sp = {}, parse_options const& opt = {});
This function reads data from an input stream and parses it to produce
a complete JSON entity, returned as a value. If the stream does not
contain a complete serialized JSON, or contains extra non-whitespace data,
an exception is thrown.
Linear in the size of consumed input.
Basic guarantee. Throws boost::system::system_error
on failed parse. Calls to memory_resource::allocate
may throw. The stream may throw as described by std::ios::exceptions.
A value representing the parsed JSON upon success.
|
Name |
Description |
|---|---|
|
|
The stream to read from. |
|
|
The memory resource that the new value and all of its elements will use. If this parameter is omitted, the default memory resource is used. |
|
|
The options for the parser. If this parameter is omitted, the parser will accept only standard JSON. |
parse_options,
stream_parser,
value::operator>>.
Convenience header <boost/json.hpp>