Getting Started

September 17, 2023 · View on GitHub

A few short indications on how to use this library:

Requires Clang 7 or GCC 9 (or later) with -std=c++17, or Visual Studio 2019, or other compilers with sufficient C++17 support.
The library is header-only, to install and use simply copy the directory include/tao to a convenient place and include the file include/tao/json.hpp.
The generic JSON value class is in include/tao/json/value.hpp.
To parse a JSON string representation to a JSON Value, use one of the functions in include/tao/json/from_string.hpp or include/tao/json/from_file.hpp.
To produce a JSON string representation from a JSON Value, use one of the appropriate functions in include/tao/json/to_string.hpp or include/tao/json/stream.hpp.

TODO: Hello-world-sized example. TODO: Which other pages to reference here? TODO: Which other concepts to reference here?

The taocpp/json library is built around two main concepts, the Value class and the Events interface.

See also the page on common use cases for how to do some frequently required things.