// (1) static std::vector<std::uint8_t> to_bjdata(const basic_json& j, const bool use_size = false, const bool use_type = false); // (2) static void to_bjdata(const basic_json& j, detail::output_adapter<std::uint8_t> o, const bool use_size = false, const bool use_type = false); static void to_bjdata(const basic_json& j, detail::output_adapter<char> o, const bool use_size = false, const bool use_type = false);
Serializes a given JSON value j
to a byte vector using the BJData (Binary JData) serialization format. BJData aims to be more compact than JSON itself, yet more efficient to parse.
The exact mapping and its limitations is described on a dedicated page.
j
(in) : JSON value to serialize
o
(in) : output adapter to write serialization to
use_size
(in) : whether to add size annotations to container types; optional, #!cpp false
by default.
use_type
(in) : whether to add type annotations to container types (must be combined with #!cpp use_size = true
); optional, #!cpp false
by default.
Strong guarantee: if an exception is thrown, there are no changes in the JSON value.
Linear in the size of the JSON value j
.
??? example
The example shows the serialization of a JSON value to a byte vector in BJData format. ```cpp --8<-- "examples/to_bjdata.cpp" ``` Output: ```json --8<-- "examples/to_bjdata.output" ```