https://github.com/eteran/cpp-json
A fast & modern C++17 JSON library
https://github.com/eteran/cpp-json
c-plus-plus cpp-json json json-parsing-library unicode
Last synced: about 2 months ago
JSON representation
A fast & modern C++17 JSON library
- Host: GitHub
- URL: https://github.com/eteran/cpp-json
- Owner: eteran
- License: other
- Created: 2015-03-20T21:03:06.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-02-13T16:28:42.000Z (over 1 year ago)
- Last Synced: 2024-05-01T13:38:49.715Z (about 1 year ago)
- Topics: c-plus-plus, cpp-json, json, json-parsing-library, unicode
- Language: C++
- Homepage:
- Size: 228 KB
- Stars: 52
- Watchers: 9
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
**cpp-json is licensed under the GNU General Public License, version 2 or later.**
**NOTE:** version [4.1](https://github.com/eteran/cpp-json/releases/tag/4.1) will be the last to not require C++17.
**NOTE:** version [2.2](https://github.com/eteran/cpp-json/releases/tag/2.2) will be the last to not require C++11.
There are a few different JSON parsing libraries out there. But cpp-json aims to be the simplest to use while still being efficient by using modern c++ techniques. Additionally, this library is header only making it trivial to include in existing projects.
Currently, the only active item on the TODO list is to better support Unicode. Unicode is generally **well supported** in the form of `\uXXXX` encoding, including code points which require surrogate pairs. The resulting `json::value` object will contain the string, encoded as UTF-8 since it is stored in a `std::string`. But there is no runtime detection or endian-ness detection based on the first few bytes (yet).
Of course special consideration is needed when displaying these strings if they do in fact contain non ASCII characters.
So, for example,
```json
{ "test1": "\uD840\uDC8A" }
```
will correctly parse and the object's "test1" member will have the byte sequence: `0xF0 0xA0 0x82 0x8A`
Here is a simple example of the usage of this library:
```c++
#include "cpp-json/json.h"
#include
#include
int main() {
// open a file
std::ifstream file("test.json");
// load the file into a string
std::string contents = std::string{std::istreambuf_iterator(file), std::istreambuf_iterator()};
// json::parse can take anything convertible to a string_view
json::value json = json::parse(contents);
// you can access objects like associative array's easily
// the result is a json::value
// ... though in real code you may want to check the type first ;-)
auto servlets = json["web-app"]["servlet"];
// when dealing with arrays, you can use iterators, indexing, or ranged-for
for(const json::value &v : as_array(servlets)) {
// all basic types (numbers, strings, booleans) can be converted
// to a string
std::cout << to_string(v["servlet-name"]) << '\n';
}
}
```
You can also programmatically create `json::value` objects like this:
```c++
int main(int argc, char *argv[]) {
auto arr = json::array {
1,
2,
3,
4,
"Testing 1 2 3",
json::object{
{ "hello", 1234 },
{ "world", 5678 }
}
};
std::cout << stringify(arr) << std::endl;
}
```
Which of course results in a object representing the following JSON:
```json
[
1,
2,
3,
4,
"Testing 1 2 3",
{
"hello": 1234,
"world": 5678
}
]
```
Finally, this library is very fast, when processing a 190 MB JSON file I randomly selected, parsing took no more than 18 seconds on my machine. For a Qt4 JSON parsing library, you can also checkout my other project: [QJson4](https://github.com/eteran/qjson4)