sjson-cpp

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 SJSON format

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

Unicode support

UTF-8 support is as follow:

String values return a raw StringView into 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.

Supported platforms

Windows VS2015 x86 and x64
Windows (VS2017, VS2019) x86, x64, and ARM64
Windows VS2019 with clang9 x86 and x64
Linux (gcc 5 to 10) x86 and x64
Linux (clang 4 to 11) x86 and x64
OS X (Xcode 10.3) x86 and x64
OS X (Xcode 11.7, 12.5, 13.2) x64 and ARM64
Android (NDK 21) ARMv7-A and ARM64
iOS (Xcode 10.3, 11.7, 12.5, 13.2) ARM64
Emscripten (1.39.11) WASM

The above supported platform list is only what is tested every release but if it compiles, it should run just fine.

External dependencies

There are none! You don't need anything else to get started: everything is self contained. See here for details.

Getting up and running

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.

Windows, Linux, and OS X for x86 and x64

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 --init to 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

Windows ARM64

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

Android

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.

iOS

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.