Skip to content

Latest commit

 

History

History
63 lines (45 loc) · 2.82 KB

decode_ubjson.md

File metadata and controls

63 lines (45 loc) · 2.82 KB

jsoncons::ubjson::decode_ubjson

Decodes a Universal Binary JSON Specification (JSON) data format into a C++ data structure.

#include <jsoncons_ext/ubjson/ubjson.hpp>

template<class T>
T decode_ubjson(const std::vector<uint8_t>& source,
                const bson_decode_options& options = bson_decode_options()); // (1) (until v0.152.0)

template<class T, class Source>
T decode_ubjson(const Source& source,
                const bson_decode_options& options = bson_decode_options()); // (1) (since v0.152.0)

template<class T>
T decode_ubjson(std::istream>& is,
                const bson_decode_options& options = bson_decode_options()); // (2)

template<class T, class InputIt>
T decode_ubjson(InputIt first, InputIt last,
                const bson_decode_options& options = bson_decode_options()); // (3)

template<class T, class TempAllocator>
T decode_ubjson(temp_allocator_arg_t, const TempAllocator& temp_alloc,
                const std::vector<uint8_t>& source,
                const bson_decode_options& options = bson_decode_options()); // (4) (until v0.152.0)

template<class T, class Source, class TempAllocator>
T decode_ubjson(temp_allocator_arg_t, const TempAllocator& temp_alloc,
                const Source& source,
                const bson_decode_options& options = bson_decode_options()); // (4) (since v0.152.0)

template<class T,class TempAllocator>
T decode_ubjson(temp_allocator_arg_t, const TempAllocator& temp_alloc,
                std::istream>& is,
                const bson_decode_options& options = bson_decode_options()); // (5)

(1) Reads UBJSON data from a contiguous byte sequence provided by source into a type T, using the specified (or defaulted) options. Type Source must be a container that has member functions data() and size(), and member type value_type with size exactly 8 bits (since v0.152.0.) Any of the values types int8_t, uint8_t, char, unsigned char and std::byte (since C++17) are allowed. Type 'T' must be an instantiation of basic_json or support json_type_traits.

(2) Reads UBJSON data from a binary stream into a type T, using the specified (or defaulted) options. Type 'T' must be an instantiation of basic_json or support json_type_traits.

(3) Reads UBJSON data from the range [first,last) into a type T, using the specified (or defaulted) options. Type 'T' must be an instantiation of basic_json or support json_type_traits.

Exceptions

Throws a ser_error if parsing fails.

See also

encode_ubjson encodes a json value to the Universal Binary JSON Specification data format.