jsoncpp/README.md

# JsonCpp

[![badge](https://img.shields.io/badge/conan.io-jsoncpp%2F1.8.0-green.svg?logo=data:image/png;base64%2CiVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAMAAAAolt3jAAAA1VBMVEUAAABhlctjlstkl8tlmMtlmMxlmcxmmcxnmsxpnMxpnM1qnc1sn85voM91oM11oc1xotB2oc56pNF6pNJ2ptJ8ptJ8ptN9ptN8p9N5qNJ9p9N9p9R8qtOBqdSAqtOAqtR%2BrNSCrNJ/rdWDrNWCsNWCsNaJs9eLs9iRvNuVvdyVv9yXwd2Zwt6axN6dxt%2Bfx%2BChyeGiyuGjyuCjyuGly%2BGlzOKmzOGozuKoz%2BKqz%2BOq0OOv1OWw1OWw1eWx1eWy1uay1%2Baz1%2Baz1%2Bez2Oe02Oe12ee22ujUGwH3AAAAAXRSTlMAQObYZgAAAAFiS0dEAIgFHUgAAAAJcEhZcwAACxMAAAsTAQCanBgAAAAHdElNRQfgBQkREyOxFIh/AAAAiklEQVQI12NgAAMbOwY4sLZ2NtQ1coVKWNvoc/Eq8XDr2wB5Ig62ekza9vaOqpK2TpoMzOxaFtwqZua2Bm4makIM7OzMAjoaCqYuxooSUqJALjs7o4yVpbowvzSUy87KqSwmxQfnsrPISyFzWeWAXCkpMaBVIC4bmCsOdgiUKwh3JojLgAQ4ZCE0AMm2D29tZwe6AAAAAElFTkSuQmCC)](https://bintray.com/theirix/conan-repo/jsoncpp%3Atheirix)
[![badge](https://img.shields.io/badge/license-MIT-blue)](https://github.com/open-source-parsers/jsoncpp/blob/master/LICENSE)
[![badge](https://img.shields.io/badge/document-doxygen-brightgreen)](http://open-source-parsers.github.io/jsoncpp-docs/doxygen/index.html)
[![Coverage Status](https://coveralls.io/repos/github/open-source-parsers/jsoncpp/badge.svg?branch=master)](https://coveralls.io/github/open-source-parsers/jsoncpp?branch=master)


[JSON][json-org] is a lightweight data-interchange format. It can represent
numbers, strings, ordered sequences of values, and collections of name/value
pairs.

[json-org]: http://json.org/

JsonCpp is a C++ library that allows manipulating JSON values, including
serialization and deserialization to and from strings. It can also preserve
existing comment in unserialization/serialization steps, making it a convenient
format to store user input files.


## Documentation

[JsonCpp documentation][JsonCpp-documentation] is generated using [Doxygen][].

[JsonCpp-documentation]: http://open-source-parsers.github.io/jsoncpp-docs/doxygen/index.html
[Doxygen]: http://www.doxygen.org


## A note on backward-compatibility

* `1.y.z` is built with C++11.
* `0.y.z` can be used with older compilers.
* Major versions maintain binary-compatibility.


## Using JsonCpp in your project

### The vcpkg dependency manager
You can download and install JsonCpp using the [vcpkg](https://github.com/Microsoft/vcpkg/) dependency manager:

    git clone https://github.com/Microsoft/vcpkg.git
    cd vcpkg
    ./bootstrap-vcpkg.sh
    ./vcpkg integrate install
    vcpkg install jsoncpp

The JsonCpp port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.

### Amalgamated source
https://github.com/open-source-parsers/jsoncpp/wiki/Amalgamated-(Possibly-outdated)

### The Meson Build System
If you are using the [Meson Build System](http://mesonbuild.com), then you can get a wrap file by downloading it from [Meson WrapDB](https://wrapdb.mesonbuild.com/jsoncpp), or simply use `meson wrap install jsoncpp`.

### Other ways
If you have trouble, see the [Wiki](https://github.com/open-source-parsers/jsoncpp/wiki), or post a question as an Issue.

## License

See the `LICENSE` file for details. In summary, JsonCpp is licensed under the
MIT license, or public domain if desired and recognized in your jurisdiction.
README: Give some love. 2017-01-12 10:57:34 +01:00			`# JsonCpp`
Stripped carriage return and added eol-style native prop. 2007-06-14 23:01:26 +02:00
Update README.md Update the link to the conan page, as https://conan.io/source/jsoncpp/1.8.0/theirix/ci returns a 404. 2019-03-18 14:02:50 +01:00			[![badge](https://img.shields.io/badge/conan.io-jsoncpp%2F1.8.0-green.svg?logo=data:image/png;base64%2CiVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAMAAAAolt3jAAAA1VBMVEUAAABhlctjlstkl8tlmMtlmMxlmcxmmcxnmsxpnMxpnM1qnc1sn85voM91oM11oc1xotB2oc56pNF6pNJ2ptJ8ptJ8ptN9ptN8p9N5qNJ9p9N9p9R8qtOBqdSAqtOAqtR%2BrNSCrNJ/rdWDrNWCsNWCsNaJs9eLs9iRvNuVvdyVv9yXwd2Zwt6axN6dxt%2Bfx%2BChyeGiyuGjyuCjyuGly%2BGlzOKmzOGozuKoz%2BKqz%2BOq0OOv1OWw1OWw1eWx1eWy1uay1%2Baz1%2Baz1%2Bez2Oe02Oe12ee22ujUGwH3AAAAAXRSTlMAQObYZgAAAAFiS0dEAIgFHUgAAAAJcEhZcwAACxMAAAsTAQCanBgAAAAHdElNRQfgBQkREyOxFIh/AAAAiklEQVQI12NgAAMbOwY4sLZ2NtQ1coVKWNvoc/Eq8XDr2wB5Ig62ekza9vaOqpK2TpoMzOxaFtwqZua2Bm4makIM7OzMAjoaCqYuxooSUqJALjs7o4yVpbowvzSUy87KqSwmxQfnsrPISyFzWeWAXCkpMaBVIC4bmCsOdgiUKwh3JojLgAQ4ZCE0AMm2D29tZwe6AAAAAElFTkSuQmCC)](https://bintray.com/theirix/conan-repo/jsoncpp%3Atheirix)
modify README.md: add some badges (#1070) 2019-10-25 11:12:11 +02:00			`[![badge](https://img.shields.io/badge/license-MIT-blue)](https://github.com/open-source-parsers/jsoncpp/blob/master/LICENSE)`
			`[![badge](https://img.shields.io/badge/document-doxygen-brightgreen)](http://open-source-parsers.github.io/jsoncpp-docs/doxygen/index.html)`
Update coverage badge (#1088) update coverage badge change int to Json::ArrayIndex in for-loop 2019-11-07 08:25:06 +01:00			`[![Coverage Status](https://coveralls.io/repos/github/open-source-parsers/jsoncpp/badge.svg?branch=master)](https://coveralls.io/github/open-source-parsers/jsoncpp?branch=master)`
modify README.md: add some badges (#1070) 2019-10-25 11:12:11 +02:00
Including instructions in how to use jsonCpp with conan Also added the badge to the conan package. Related to issue #564 2017-04-09 19:14:38 +02:00
Gave the introduction section a makeover. 2014-07-01 03:56:56 +02:00			`[JSON][json-org] is a lightweight data-interchange format. It can represent`
			`numbers, strings, ordered sequences of values, and collections of name/value`
			`pairs.`
Stripped carriage return and added eol-style native prop. 2007-06-14 23:01:26 +02:00
Gave the introduction section a makeover. 2014-07-01 03:56:56 +02:00			`[json-org]: http://json.org/`
Stripped carriage return and added eol-style native prop. 2007-06-14 23:01:26 +02:00
README: Give some love. 2017-01-12 10:57:34 +01:00			`JsonCpp is a C++ library that allows manipulating JSON values, including`
Gave the introduction section a makeover. 2014-07-01 03:56:56 +02:00			`serialization and deserialization to and from strings. It can also preserve`
			`existing comment in unserialization/serialization steps, making it a convenient`
			`format to store user input files.`
Stripped carriage return and added eol-style native prop. 2007-06-14 23:01:26 +02:00
README: Give some love. 2017-01-12 10:57:34 +01:00
			`## Documentation`

			`[JsonCpp documentation][JsonCpp-documentation] is generated using [Doxygen][].`

			`[JsonCpp-documentation]: http://open-source-parsers.github.io/jsoncpp-docs/doxygen/index.html`
			`[Doxygen]: http://www.doxygen.org`

link web docs 2015-02-12 18:18:23 +01:00
Update README.md Note on C++11 2014-11-03 19:39:01 +01:00			`## A note on backward-compatibility`
README: Give some love. 2017-01-12 10:57:34 +01:00
link web docs 2015-02-12 18:18:23 +01:00			* `1.y.z` is built with C++11.
clarify which versions work with old compilers 2015-03-06 04:45:42 +01:00			* `0.y.z` can be used with older compilers.
link web docs 2015-02-12 18:18:23 +01:00			`* Major versions maintain binary-compatibility.`
- New CMake based build system. Based in part on contribution from Igor Okulist and Damien Buhl (Patch #14). Added support for running tests and building with DLL on Windows. - added missing JSON_API - Visual Studio DLL: suppressed warning "C4251: <data member>: <type> needs to have dll-interface to be used by..." via pragma push/pop in json-cpp headers. - New header json/version.h now contains version number macros (JSONCPP_VERSION_MAJOR, JSONCPP_VERSION_MINOR, JSONCPP_VERSION_PATCH and JSONCPP_VERSION_HEXA). While this header is generated by CMake, it is committed to ease build with alternate build system (CMake only update the file when it changes avoid issues with VCS). 2013-05-08 22:21:11 +02:00
JsonCpp is now licensed under MIT license, or public domain if desired and recognized in your jurisdiction. 2010-04-20 23:35:19 +02:00
Move amalgamated source details to wiki 2017-08-27 22:16:43 +02:00			`## Using JsonCpp in your project`

Add vcpkg installation instructions (#1037) 2019-10-01 21:53:42 +02:00			`### The vcpkg dependency manager`
			`You can download and install JsonCpp using the [vcpkg](https://github.com/Microsoft/vcpkg/) dependency manager:`

			`git clone https://github.com/Microsoft/vcpkg.git`
			`cd vcpkg`
			`./bootstrap-vcpkg.sh`
			`./vcpkg integrate install`
			`vcpkg install jsoncpp`

			`The JsonCpp port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.`

Move amalgamated source details to wiki 2017-08-27 22:16:43 +02:00			`### Amalgamated source`
Fix link to Amalgamated wiki article (#1064) 2019-10-18 20:06:56 +02:00			`https://github.com/open-source-parsers/jsoncpp/wiki/Amalgamated-(Possibly-outdated)`
Move amalgamated source details to wiki 2017-08-27 22:16:43 +02:00
Add Meson related info to README Add information about how one can get a Meson wrap file. Signed-off-by: Kostiantyn Ponomarenko <konstantin.ponomarenko@gmail.com> 2018-10-18 19:12:46 +02:00			`### The Meson Build System`
			If you are using the [Meson Build System](http://mesonbuild.com), then you can get a wrap file by downloading it from [Meson WrapDB](https://wrapdb.mesonbuild.com/jsoncpp), or simply use `meson wrap install jsoncpp`.

Move amalgamated source details to wiki 2017-08-27 22:16:43 +02:00			`### Other ways`
modify README.md: add some badges (#1070) 2019-10-25 11:12:11 +02:00			`If you have trouble, see the [Wiki](https://github.com/open-source-parsers/jsoncpp/wiki), or post a question as an Issue.`
Move amalgamated source details to wiki 2017-08-27 22:16:43 +02:00
README: Give some love. 2017-01-12 10:57:34 +01:00			`## License`

Gave the license section a makeover. 2014-07-01 05:13:46 +02:00			See the `LICENSE` file for details. In summary, JsonCpp is licensed under the
JsonCpp is now licensed under MIT license, or public domain if desired and recognized in your jurisdiction. 2010-04-20 23:35:19 +02:00			`MIT license, or public domain if desired and recognized in your jurisdiction.`