// (1) template<typename InputType> static basic_json from_bjdata(InputType&& i, const bool strict = true, const bool allow_exceptions = true); // (2) template<typename IteratorType> static basic_json from_bjdata(IteratorType first, IteratorType last, const bool strict = true, const bool allow_exceptions = true);
Deserializes a given input to a JSON value using the BJData (Binary JData) serialization format.
The exact mapping and its limitations is described on a dedicated page.
InputType
: A compatible input, for instance:
- an `std::istream` object - a `FILE` pointer - a C-style array of characters - a pointer to a null-terminated string of single byte characters - an object `obj` for which `begin(obj)` and `end(obj)` produces a valid pair of iterators.
IteratorType
: a compatible iterator type
i
(in) : an input in BJData format convertible to an input adapter
first
(in) : iterator to start of the input
last
(in) : iterator to end of the input
strict
(in) : whether to expect the input to be consumed until EOF (#!cpp true
by default)
allow_exceptions
(in) : whether to throw exceptions in case of a parse error (optional, #!cpp true
by default)
deserialized JSON value; in case of a parse error and allow_exceptions
set to #!cpp false
, the return value will be value_t::discarded
. The latter can be checked with is_discarded
.
Strong guarantee: if an exception is thrown, there are no changes in the JSON value.
strict
was set to trueLinear in the size of the input.
??? example
The example shows the deserialization of a byte vector in BJData format to a JSON value. ```cpp --8<-- "examples/from_bjdata.cpp" ``` Output: ```json --8<-- "examples/from_bjdata.output" ```