lib/yyjson-0.12.0/doc/doxygen/html/index.html
| yyjson 0.12.0
A high performance C JSON library. |
Loading...
Searching...
No Matches
Introduction
A high performance JSON library written in ANSI C.
int64, uint64, and double numbers.\u0000 characters, and non-null-terminated strings..h and one .c file.mutable copy for modification.Benchmark project and dataset: yyjson_benchmark
The simdjson's new On Demand API is faster if most JSON fields are known at compile-time. This benchmark project only checks the DOM API, a new benchmark will be added later.
| twitter.json | parse (GB/s) | stringify (GB/s) |
|---|---|---|
| yyjson(insitu) | 1.80 | 1.51 |
| yyjson | 1.72 | 1.42 |
| simdjson | 1.52 | 0.61 |
| sajson | 1.16 | |
| rapidjson(insitu) | 0.77 | |
| rapidjson(utf8) | 0.26 | 0.39 |
| cjson | 0.32 | 0.17 |
| jansson | 0.05 | 0.11 |
| twitter.json | parse (GB/s) | stringify (GB/s) |
|---|---|---|
| yyjson(insitu) | 3.51 | 2.41 |
| yyjson | 2.39 | 2.01 |
| simdjson | 2.19 | 0.80 |
| sajson | 1.74 | |
| rapidjson(insitu) | 0.75 | |
| rapidjson(utf8) | 0.30 | 0.58 |
| cjson | 0.48 | 0.33 |
| jansson | 0.09 | 0.24 |
More benchmark reports with interactive charts (update 2020-12-12)
| Platform | CPU | Compiler | OS | Report |
|---|---|---|---|---|
| Intel NUC 8i5 | Core i5-8259U | msvc 2019 | Windows 10 2004 | Charts |
| Intel NUC 8i5 | Core i5-8259U | clang 10.0 | Ubuntu 20.04 | Charts |
| Intel NUC 8i5 | Core i5-8259U | gcc 9.3 | Ubuntu 20.04 | Charts |
| AWS EC2 c5a.large | AMD EPYC 7R32 | gcc 9.3 | Ubuntu 20.04 | Charts |
| AWS EC2 t4g.medium | Graviton2 (ARM64) | gcc 9.3 | Ubuntu 20.04 | Charts |
| Apple iPhone 12 Pro | A14 (ARM64) | clang 12.0 | iOS 14 | Charts |
A modern processor with:
A modern compiler with good optimizer (e.g. clang)
const char *json = "{"name":"Mash","star":4,"hits":[2,2,1,3]}";
// Read JSON and get root
yyjson_doc *doc = yyjson_read(json, strlen(json), 0);
yyjson_val *root = yyjson_doc_get_root(doc);
// Get root["name"]
yyjson_val *name = yyjson_obj_get(root, "name");
printf("name: %s\n", yyjson_get_str(name));
printf("name length:%d\n", (int)yyjson_get_len(name));
// Get root["star"]
yyjson_val *star = yyjson_obj_get(root, "star");
printf("star: %d\n", (int)yyjson_get_int(star));
// Get root["hits"], iterate over the array
yyjson_val *hits = yyjson_obj_get(root, "hits");
size_t idx, max;
yyjson_val *hit;
yyjson_arr_foreach(hits, idx, max, hit) {
printf("hit%d: %d\n", (int)idx, (int)yyjson_get_int(hit));
}
// Free the doc
yyjson_doc_free(doc);
// All functions accept NULL input, and return NULL on error.
yyjson_api_inline yyjson_val * yyjson_obj_get(yyjson_val *obj, const char *key)
Definition yyjson.h:5483
yyjson_api_inline int yyjson_get_int(yyjson_val *val)
Definition yyjson.h:5252
#define yyjson_arr_foreach(arr, idx, max, val)
Definition yyjson.h:2046
yyjson_api_inline const char * yyjson_get_str(yyjson_val *val)
Definition yyjson.h:5264
yyjson_api_inline yyjson_val * yyjson_doc_get_root(yyjson_doc *doc)
Definition yyjson.h:5118
yyjson_api_inline void yyjson_doc_free(yyjson_doc *doc)
Definition yyjson.h:5130
yyjson_api_inline size_t yyjson_get_len(yyjson_val *val)
Definition yyjson.h:5268
yyjson_api_inline yyjson_doc * yyjson_read(const char *dat, size_t len, yyjson_read_flag flg)
Definition yyjson.h:983
Definition yyjson.h:4770
Definition yyjson.h:4765
// Create a mutable doc
[yyjson_mut_doc](yyjson_8h.html#structyyjson mut doc) *doc = yyjson_mut_doc_new(NULL);
[yyjson_mut_val](yyjson_8h.html#structyyjson mut val) *root = yyjson_mut_obj(doc);
yyjson_mut_doc_set_root(doc, root);
// Set root["name"] and root["star"]
yyjson_mut_obj_add_str(doc, root, "name", "Mash");
yyjson_mut_obj_add_int(doc, root, "star", 4);
// Set root["hits"] with an array
int hits_arr[] = {2, 2, 1, 3};
[yyjson_mut_val](yyjson_8h.html#structyyjson mut val) *hits = yyjson_mut_arr_with_sint32(doc, hits_arr, 4);
yyjson_mut_obj_add_val(doc, root, "hits", hits);
// To string, minified
const char *json = yyjson_mut_write(doc, 0, NULL);
if (json) {
printf("json: %s\n", json); // {"name":"Mash","star":4,"hits":[2,2,1,3]}
free((void *)json);
}
// Free the doc
yyjson_mut_doc_free(doc);
yyjson_api_inline bool yyjson_mut_obj_add_val(yyjson_mut_doc *doc, yyjson_mut_val *obj, const char *key, yyjson_mut_val *val)
Definition yyjson.h:7297
yyjson_api_inline yyjson_mut_val * yyjson_mut_arr_with_sint32(yyjson_mut_doc *doc, const int32_t *vals, size_t count)
Definition yyjson.h:6264
yyjson_api_inline bool yyjson_mut_obj_add_int(yyjson_mut_doc *doc, yyjson_mut_val *obj, const char *key, int64_t val)
Definition yyjson.h:7201
yyjson_api_inline yyjson_mut_val * yyjson_mut_obj(yyjson_mut_doc *doc)
Definition yyjson.h:6870
yyjson_api void yyjson_mut_doc_free(yyjson_mut_doc *doc)
yyjson_api_inline char * yyjson_mut_write(const yyjson_mut_doc *doc, yyjson_write_flag flg, size_t *len)
Definition yyjson.h:1461
yyjson_api_inline void yyjson_mut_doc_set_root(yyjson_mut_doc *doc, yyjson_mut_val *root)
Definition yyjson.h:5705
yyjson_api_inline bool yyjson_mut_obj_add_str(yyjson_mut_doc *doc, yyjson_mut_val *obj, const char *key, const char *val)
Definition yyjson.h:7229
yyjson_api yyjson_mut_doc * yyjson_mut_doc_new(const yyjson_alc *alc)
[yyjson_mut_doc](yyjson_8h.html#structyyjson mut doc)
Definition yyjson.h:5638
[yyjson_mut_val](yyjson_8h.html#structyyjson mut val)
Definition yyjson.h:5590
// Read JSON file, allowing comments and trailing commas
yyjson_read_flag flg = YYJSON_READ_ALLOW_COMMENTS | YYJSON_READ_ALLOW_TRAILING_COMMAS;
[yyjson_read_err](yyjson_8h.html#structyyjson read err) err;
yyjson_doc *doc = yyjson_read_file("/tmp/config.json", flg, NULL, &err);
// Iterate over the root object
if (doc) {
yyjson_val *obj = yyjson_doc_get_root(doc);
[yyjson_obj_iter](yyjson_8h.html#structyyjson obj iter) iter;
yyjson_obj_iter_init(obj, &iter);
yyjson_val *key, *val;
while ((key = yyjson_obj_iter_next(&iter))) {
val = yyjson_obj_iter_get_val(key);
printf("%s: %s\n", yyjson_get_str(key), yyjson_get_type_desc(val));
}
} else {
printf("read error (%u): %s at position: %ld\n", err.code, err.msg, err.pos);
}
// Free the doc
yyjson_doc_free(doc);
YYJSON_READ_ALLOW_TRAILING_COMMAS
static const yyjson_read_flag YYJSON_READ_ALLOW_TRAILING_COMMAS
Definition yyjson.h:750
yyjson_api_inline bool yyjson_obj_iter_init(yyjson_val *obj, yyjson_obj_iter *iter)
Definition yyjson.h:5508
yyjson_api_inline yyjson_val * yyjson_obj_iter_get_val(yyjson_val *key)
Definition yyjson.h:5541
uint32_t yyjson_read_flag
Definition yyjson.h:723
yyjson_api_inline const char * yyjson_get_type_desc(yyjson_val *val)
Definition yyjson.h:5219
yyjson_read_code code
Definition yyjson.h:881
yyjson_api_inline yyjson_val * yyjson_obj_iter_next(yyjson_obj_iter *iter)
Definition yyjson.h:5531
yyjson_api yyjson_doc * yyjson_read_file(const char *path, yyjson_read_flag flg, const yyjson_alc *alc, yyjson_read_err *err)
size_t pos
Definition yyjson.h:885
const char * msg
Definition yyjson.h:883
static const yyjson_read_flag YYJSON_READ_ALLOW_COMMENTS
Definition yyjson.h:753
[yyjson_obj_iter](yyjson_8h.html#structyyjson obj iter)
Definition yyjson.h:2114
[yyjson_read_err](yyjson_8h.html#structyyjson read err)
Definition yyjson.h:879
// Read the JSON file as a mutable doc
yyjson_doc *idoc = yyjson_read_file("/tmp/config.json", 0, NULL, NULL);
[yyjson_mut_doc](yyjson_8h.html#structyyjson mut doc) *doc = yyjson_doc_mut_copy(idoc, NULL);
[yyjson_mut_val](yyjson_8h.html#structyyjson mut val) *obj = yyjson_mut_doc_get_root(doc);
// Remove null values in root object
[yyjson_mut_obj_iter](yyjson_8h.html#structyyjson mut obj__iter) iter;
yyjson_mut_obj_iter_init(obj, &iter);
[yyjson_mut_val](yyjson_8h.html#structyyjson mut val) *key, *val;
while ((key = yyjson_mut_obj_iter_next(&iter))) {
val = yyjson_mut_obj_iter_get_val(key);
if (yyjson_mut_is_null(val)) {
yyjson_mut_obj_iter_remove(&iter);
}
}
// Write the json pretty, escape unicode
yyjson_write_flag flg = YYJSON_WRITE_PRETTY | YYJSON_WRITE_ESCAPE_UNICODE;
[yyjson_write_err](yyjson_8h.html#structyyjson write err) err;
yyjson_mut_write_file("/tmp/config.json", doc, flg, NULL, &err);
if (err.code) {
printf("write error (%u): %s\n", err.code, err.msg);
}
// Free the doc
yyjson_doc_free(idoc);
yyjson_mut_doc_free(doc);
yyjson_api yyjson_mut_doc * yyjson_doc_mut_copy(yyjson_doc *doc, const yyjson_alc *alc)
yyjson_api_inline bool yyjson_mut_is_null(yyjson_mut_val *val)
Definition yyjson.h:5720
const char * msg
Definition yyjson.h:1251
yyjson_api_inline yyjson_mut_val * yyjson_mut_obj_iter_next(yyjson_mut_obj_iter *iter)
Definition yyjson.h:6804
yyjson_api_inline yyjson_mut_val * yyjson_mut_obj_iter_remove(yyjson_mut_obj_iter *iter)
Definition yyjson.h:6821
yyjson_api_inline yyjson_mut_val * yyjson_mut_doc_get_root(yyjson_mut_doc *doc)
Definition yyjson.h:5701
yyjson_api_inline yyjson_mut_val * yyjson_mut_obj_iter_get_val(yyjson_mut_val *key)
Definition yyjson.h:6816
static const yyjson_write_flag YYJSON_WRITE_ESCAPE_UNICODE
Definition yyjson.h:1168
yyjson_api bool yyjson_mut_write_file(const char *path, const yyjson_mut_doc *doc, yyjson_write_flag flg, const yyjson_alc *alc, yyjson_write_err *err)
yyjson_api_inline bool yyjson_mut_obj_iter_init(yyjson_mut_val *obj, yyjson_mut_obj_iter *iter)
Definition yyjson.h:6779
yyjson_write_code code
Definition yyjson.h:1249
static const yyjson_write_flag YYJSON_WRITE_PRETTY
Definition yyjson.h:1165
uint32_t yyjson_write_flag
Definition yyjson.h:1155
[yyjson_mut_obj_iter](yyjson_8h.html#structyyjson mut obj__iter)
Definition yyjson.h:3537
[yyjson_write_err](yyjson_8h.html#structyyjson write err)
Definition yyjson.h:1247
The latest (unreleased) documentation can be accessed in the doc directory. The pre-generated Doxygen HTML for the release version can be viewed here:
A non-exhaustive list of projects that expose yyjson to other languages or use yyjson internally for a major feature. If you have a project that uses yyjson, feel free to open a PR to add it to this list.
| Project | Language | Description |
|---|---|---|
| py_yyjson | Python | Python bindings for yyjson |
| orjson | Python | JSON library for Python with an optional yyjson backend |
| cpp-yyjson | C++ | C++ JSON library with a yyjson backend |
| reflect-cpp | C++ | C++ library for serialization through automated field name retrieval from structs |
| yyjsonr | R | R binding for yyjson |
| Ananda | Swift | JSON model decoding based on yyjson |
| duckdb | C++ | DuckDB is an in-process SQL OLAP Database Management System |
| fastfetch | C | A neofetch-like tool for fetching system information and displaying them in a pretty way |
| Zrythm | C | Digital Audio Workstation that uses yyjson to serialize JSON project files |
| bemorehuman | C | Recommendation engine with a focus on uniqueness of the person receiving the rec |
| mruby-yyjson | mruby | Efficient JSON parsing and serialization library for mruby using yyjson |
| YYJSON.jl | Julia | Julia bindings for yyjson |
RAW type for JSON reader and writer.This project is released under the MIT license.