# json **Repository Path**: iotyib/json ## Basic Information - **Project Name**: json - **Description**: LJSON 是一个远远快于 cJSON(最快可达20倍)、大幅度快于 RapidJSON (最快可达1倍)的 C 实现的 JSON 库，他是目前最快的通用 JSON 库。 LJSON 支持 JSON 的解析、打印、编辑，提供 DOM 和 SAX 接口，I/O 支持字符串和文件，且完全支持 nativejson-benchmark 的测试用例。 - **Primary Language**: C - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 25 - **Created**: 2023-07-04 - **Last Updated**: 2023-07-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # LJSON Description [中文版](./README_zh-cn.md) LJSON is a C implemented JSON library that is much faster than cJSON and substantially faster than RapidJSON, it is currently the fastest general-purpose JSON library. LJSON supports JSON parsing, printing and editing, provides DOM and SAX APIs, and I/O supports string and file, it fully supports the test cases of nativejson-benchmark. LJSON uses the grisu2 algorithm to print double number: the default implementation of grisu2 is **5.7** times faster than sprintf, the pre-optimal implementation is **9.1** times faster than sprintf, and the implementation of LJSON is **11.4** times faster than sprintf. ## Features * Faster: Print and parse faster than both cJSON and RapidJSON, up to 19 times faster than CJSON and 1 time faster than Rapid JSON, refer to below test results * Lighter: Provide a variety of methods to save memory, such as pool memory, file parsing while reading, file writing while printing, and SAX APIs. It can make memory usage a constant * Stronger: Support DOM and SAX-style APIs, provide APIs for JSON in classic mode and memory pool mode, support string and file as input and output, is extended to support long long integer and hexadecimal number * More friendly: C language implementation, does not depend on any other library, does not contain platform-related code, only one header file and source file, and the interface corresponding to cJSON. the code logic is clearer than any other JSON libraries ## Compile and Run ### Compile Method * Compile directly ```sh gcc -o ljson json.c json_test.c -O2 -ffunction-sections -fdata-sections -W -Wall ``` * Compile with [IMAKE](https://github.com/lengjingzju/cbuild-ng) ```sh make O= && make O= DESTDIR= ``` * Cross Compile ```sh make O= CROSS_COMPILE= && make O= DESTDIR= ``` ### Run Method ```sh ./json ``` ### Debug Method * Set the value of the variable `JSON_ERROR_PRINT_ENABLE` in `json.c` to `1` and then re-compile ### Error detection * Set the value of the variable `JSON_STRICT_PARSE_MODE` in `json.c` to `0` / `1` / `2` and then re-compile * 0: Turn off not common error detection, such as trailing characters left after parsing * 1: Detect more errors and allow key to be empty string * 2: In addition to error detection enabled by 1, some non-standard features are also turned off, such as hexadecimal numbers, the first json object is not an array or object * It 100% matches the test cases of [nativejson-benchmark](https://github.com/miloyip/nativejson-benchmark) when set to 2 ## Speed Test Note: 'O2' optimization level and default option compilation, the test files come from the [nativejson-benchmark](https://github.com/miloyip/nativejson-benchmark) project > Test Platform: Ambarella CV25M Board | CPU: ARM CortexA53 | OS: Linux-5.15
> Test Result: LJSON parses 450% faster and prints 1700% faster than cJSON, LJSON parses 131% faster and prints 88% faster than RapidJSON ![AARCH64-Linux Test Result](test_result/test_for_aarch64.png) > Test Platform: PC | CPU: Intel i7-10700 | OS: Ubuntu 18.04 (VirtualBox)
> Test Result: LJSON parses 549% faster and prints 2042% faster than cJSON, LJSON parses 73% faster and prints 107% faster than RapidJSON ![x86_64-Linux Test Result](test_result/test_for_x86_64.png) ## Contact * Phone: +86 18368887550 * wx/qq: 1083936981 * Email: lengjingzju@163.com 3090101217@zju.edu.cn