|
c@75
|
1 json11
|
|
c@75
|
2 ------
|
|
c@75
|
3
|
|
c@75
|
4 json11 is a tiny JSON library for C++11, providing JSON parsing and serialization.
|
|
c@75
|
5
|
|
c@75
|
6 The core object provided by the library is json11::Json. A Json object represents any JSON
|
|
c@75
|
7 value: null, bool, number (int or double), string (std::string), array (std::vector), or
|
|
c@75
|
8 object (std::map).
|
|
c@75
|
9
|
|
c@75
|
10 Json objects act like values. They can be assigned, copied, moved, compared for equality or
|
|
c@75
|
11 order, and so on. There are also helper methods Json::dump, to serialize a Json to a string, and
|
|
c@75
|
12 Json::parse (static) to parse a std::string as a Json object.
|
|
c@75
|
13
|
|
c@75
|
14 It's easy to make a JSON object with C++11's new initializer syntax:
|
|
c@75
|
15
|
|
c@75
|
16 Json my_json = Json::object {
|
|
c@75
|
17 { "key1", "value1" },
|
|
c@75
|
18 { "key2", false },
|
|
c@75
|
19 { "key3", Json::array { 1, 2, 3 } },
|
|
c@75
|
20 };
|
|
c@75
|
21 std::string json_str = my_json.dump();
|
|
c@75
|
22
|
|
c@75
|
23 There are also implicit constructors that allow standard and user-defined types to be
|
|
c@75
|
24 automatically converted to JSON. For example:
|
|
c@75
|
25
|
|
c@75
|
26 class Point {
|
|
c@75
|
27 public:
|
|
c@75
|
28 int x;
|
|
c@75
|
29 int y;
|
|
c@75
|
30 Point (int x, int y) : x(x), y(y) {}
|
|
c@75
|
31 Json to_json() const { return Json::array { x, y }; }
|
|
c@75
|
32 };
|
|
c@75
|
33
|
|
c@75
|
34 std::vector<Point> points = { { 1, 2 }, { 10, 20 }, { 100, 200 } };
|
|
c@75
|
35 std::string points_json = Json(points).dump();
|
|
c@75
|
36
|
|
c@75
|
37 JSON values can have their values queried and inspected:
|
|
c@75
|
38
|
|
c@75
|
39 Json json = Json::array { Json::object { { "k", "v" } } };
|
|
c@75
|
40 std::string str = json[0]["k"].string_value();
|
|
c@75
|
41
|
|
c@75
|
42 More documentation is still to come. For now, see json11.hpp.
|
