sjson-cpp is a C++ library to read and write Simplified JSON files.
It aims to be minimal, fast, and get out of the way of the programmer.
By design, the library does no memory allocations. This is in contrast to the nflibs C parser.
Everything is 100% C++11 header based for easy and trivial integration.
This parser is intended to accept only pure SJSON, and it will fail if given a JSON file, unlike the Autodesk JS Stingray parser.
The data format is described here in the Stingray documentation.
TODO: Add a reference sjson file showing the format as a form of loose specification
UTF-8 support is as follow:
- String values return a raw
StringViewinto the SJSON buffer. It is the responsability of the caller to interpret it as ANSI or UTF-8. - String values properly support escaped unicode sequences in that they are returned raw in the
StringView. - Keys do not support UTF-8, they must be ANSI.
- The BOM is properly skipped if present
Unicode formats other than UTF-8 aren't supported.
- Windows VS2015 x86 and x64
- Windows (VS2017 to VS2022) x86, x64, and ARM64
- Windows (VS2017 to VS2022) with clang x86 and x64
- Linux (gcc 5 to 13) x86 and x64
- Linux (clang 4 to 15) x86 and x64
- OS X (XCode 12.5, 13.2, 14.2) x64 and ARM64
- Android (NDK 21) ARMv7-A and ARM64
- iOS (Xcode 10.3, 11.7, 12.5, 13.2, 14.2) ARM64
- Emscripten (1.39.11) WASM
- MSYS2 x64
The above supported platform list is only what is tested every release but if it compiles, it should run just fine.
There are none! You don't need anything else to get started: everything is self contained. See here for details.
This library is 100% headers as such you just need to include them in your own project to start using it. However, if you wish to run the unit tests you will need a few things, see below.
- Install CMake 3.2 or higher (3.14 for Visual Studio 2019, or 3.10 on OS X with Xcode 10), Python 2.7 or 3, and the proper compiler for your platform.
- Execute
git submodule update --initto get the files of external submodules (e.g. Catch2). - Generate the IDE solution with:
python make.py
The solution is generated under./build - Build the IDE solution with:
python make.py -build - Run the unit tests with:
python make.py -unit_test
For Windows on ARM64, the steps are identical to x86 and x64 but you will need CMake 3.13 or higher and you must provide the architecture on the command line: python make.py -compiler vs2017 -cpu arm64
For Android, the steps are identical to Windows, Linux, and OS X but you also need to install Android NDK 21 (or higher). The build uses gradle and -unit_test will deploy and run on the device when executed (make sure that the adb executable is in your PATH for this to work).
Android Studio v3.5 can be used to launch and debug. After running CMake to build and generate everything, the Android Studio projects can be found under the ./build directory.
For iOS, the steps are identical to the other platforms but due to code signing, you will need to perform the builds from Xcode manually. Note that this is only an issue if you attempt to use the tools or run the unit tests locally.
Emscripten support currently only has been tested on OS X and Linux. To use it, make sure to install a recent version of Emscripten SDK 1.39.11+.
This library uses the angular.js message format and it is enforced with commit linting through every pull request.
This project uses the MIT license.
Copyright (c) 2017 Nicholas Frechette, Cody Jones, and sjson-cpp contributors
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Thanks goes to these wonderful people (emoji key):
 CodyDWJones 💻 🚧 |
 Michał Janiszewski 💻 🚧 |
 Martin Turcotte 🚧 |
 Meradrin 🐛 |
This project follows the all-contributors specification. Contributions of any kind welcome!