1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
### jsoncons::ubjson::decode_ubjson
Decodes a [Universal Binary JSON Specification (JSON)](http://ubjson.org/) data format into a C++ data structure.
```cpp
#include <jsoncons_ext/ubjson/ubjson.hpp>
template <typename T,typename BytesLike>
T decode_ubjson(const BytesLike& source,
const bson_decode_options& options = bson_decode_options()); (1) (since 0.152.0)
template <typename T>
T decode_ubjson(std::istream>& is,
const bson_decode_options& options = bson_decode_options()); (2)
template <typename T,typename BytesLike,typename Alloc,typename TempAlloc>
T decode_ubjson(const allocator_set<Alloc,TempAlloc>& aset,
const BytesLike& source,
const ubjson_decode_options& options = ubjson_decode_options()); (3) (since 0.171.0)
template <typename T,typename Alloc,typename TempAlloc>
T decode_ubjson(const allocator_set<Alloc,TempAlloc>& aset,
std::istream& is,
const ubjson_decode_options& options = ubjson_decode_options()); (4) (since 0.171.0)
template <typename T,typename InputIt>
T decode_ubjson(InputIt first, InputIt last,
const bson_decode_options& options = bson_decode_options()); (5)
template <typename T,typename BytesLike>
read_result<T> try_decode_ubjson(const BytesLike& source,
const bson_decode_options& options = bson_decode_options()); (6) (since 1.4.0)
template <typename T>
read_result<T> try_decode_ubjson(std::istream>& is,
const bson_decode_options& options = bson_decode_options()); (7) (since 1.4.0)
template <typename T,typename BytesLike,typename Alloc,typename TempAlloc>
read_result<T> try_decode_ubjson(const allocator_set<Alloc,TempAlloc>& aset,
const BytesLike& source,
const ubjson_decode_options& options = ubjson_decode_options()); (8) (since 1.4.0)
template <typename T,typename Alloc,typename TempAlloc>
read_result<T> try_decode_ubjson(const allocator_set<Alloc,TempAlloc>& aset,
std::istream& is,
const ubjson_decode_options& options = ubjson_decode_options()); (9) (since 1.4.0)
template <typename T,typename InputIt>
read_result<T> try_decode_ubjson(InputIt first, InputIt last,
const bson_decode_options& options = bson_decode_options()); (10) (since 1.4.0)
```
(1) Reads UBJSON data from a contiguous byte sequence provided by `source` into a type T, using the specified (or defaulted) [options](ubjson_options.md).
Type `BytesLike` must be a container that has member functions `data()` and `size()`,
and member type `value_type` with size exactly 8 bits (since 0.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](../corelib/basic_json.md)
or support jsoncons reflection traits.
(2) Reads UBJSON data from a binary stream into a type T, using the specified (or defaulted) [options](ubjson_options.md).
Type 'T' must be an instantiation of [basic_json](../corelib/basic_json.md)
or support jsoncons reflection traits.
(3)-(4) are identical to (1)-(2) except an [allocator_set](allocator_set.md) is passed as an additional argument and
provides allocators for result data and temporary allocations.
(5) Reads UBJSON data from the range [`first`,`last`) into a type T, using the specified (or defaulted) [options](ubjson_options.md).
Type 'T' must be an instantiation of [basic_json](../corelib/basic_json.md)
or support jsoncons reflection traits.
(6)-(10) Non-throwing versions of (1)-(5)
#### Return value
(1)-(5) Deserialized value
(6)-(10) [read_result<T>](../corelib/read_result.md)
#### Exceptions
(1)-(5) Throw [ser_error](../corelib/ser_error.md) if read fails.
Any overload may throw `std::bad_alloc` if memory allocation fails.
### See also
[encode_ubjson](encode_ubjson.md) encodes a json value to the [Universal Binary JSON Specification](http://ubjson.org/) data format.
|
