basic_json::meta

static basic_json meta();

This function returns a JSON object with information about the library, including the version number and information on the platform and compiler.

Return value

JSON object holding version information

keydescription
compilerInformation on the used compiler. It is an object with the following keys: c++ (the used C++ standard), family (the compiler family; possible values are clang, icc, gcc, ilecpp, msvc, pgcpp, sunpro, and unknown), and version (the compiler version).
copyrightThe copyright line for the library as string.
nameThe name of the library as string.
platformThe used platform as string. Possible values are win32, linux, apple, unix, and unknown.
urlThe URL of the project as string.
versionThe version of the library. It is an object with the following keys: major, minor, and patch as defined by Semantic Versioning, and string (the version string).

Exception safety

Strong guarantee: if an exception is thrown, there are no changes to any JSON value.

Complexity

Constant.

Example

The following code shows an example output of the meta() function.

--8<-- "examples/meta.cpp"

Output:

--8<-- "examples/meta.output"

Version history

  • Added in version 2.1.0.