* Introduction:
=============
JSON (JavaScript Object Notation) is a lightweight data-interchange format.
It can represent integer, real number, string, an ordered sequence of
value, and a collection of name/value pairs.
JsonCpp is a simple API to manipulate JSON value, handle serialization
and unserialization to string.
It can also preserve existing comment in unserialization/serialization steps,
making it a convenient format to store user input files.
Unserialization parsing is user friendly and provides precise error reports.
* Building/Testing:
=================
JsonCpp uses Scons (http://www.scons.org) as a build system. Scons requires
python to be installed (http://www.python.org).
You download scons-local distribution from the following url:
http://sourceforge.net/project/showfiles.php?group_id=30337&package_id=67375
Unzip it in the directory where you found this README file. scons.py Should be
at the same level as README.
python scons.py platform=PLTFRM [TARGET]
where PLTFRM may be one of:
suncc Sun C++ (Solaris)
vacpp Visual Age C++ (AIX)
mingw
msvc6 Microsoft Visual Studio 6 service pack 5-6
msvc70 Microsoft Visual Studio 2002
msvc71 Microsoft Visual Studio 2003
msvc80 Microsoft Visual Studio 2005
linux-gcc Gnu C++ (linux, also reported to work for Mac OS X)
adding platform is fairly simple. You need to change the Sconstruct file
to do so.
and TARGET may be:
check: build library and run unit tests.
* Running the test manually:
==========================
cd test
# This will run the Reader/Writer tests
python runjsontests.py "path to jsontest.exe"
# This will run the Reader/Writer tests, using JSONChecker test suite
# (http://www.json.org/JSON_checker/).
# Notes: not all tests pass: JsonCpp is too lenient (for example,
# it allows an integer to start with '0'). The goal is to improve
# strict mode parsing to get all tests to pass.
python runjsontests.py --with-json-checker "path to jsontest.exe"
# This will run the unit tests (mostly Value)
python rununittests.py "path to test_lib_json.exe"
You can run the tests using valgrind:
python rununittests.py --valgrind "path to test_lib_json.exe"
* Building the documentation:
===========================
Run the python script doxybuild.py from the top directory:
python doxybuild.py --open --with-dot
See doxybuild.py --help for options.
* Adding a reader/writer test:
============================
To add a test, you need to create two files in test/data:
- a TESTNAME.json file, that contains the input document in JSON format.
- a TESTNAME.expected file, that contains a flatened representation of
the input document.
TESTNAME.expected file format:
- each line represents a JSON element of the element tree represented
by the input document.
- each line has two parts: the path to access the element separated from
the element value by '='. Array and object values are always empty
(e.g. represented by either [] or {}).
- element path: '.' represented the root element, and is used to separate
object members. [N] is used to specify the value of an array element
at index N.
See test_complex_01.json and test_complex_01.expected to better understand
element path.
* Understanding reader/writer test output:
========================================
When a test is run, output files are generated aside the input test files.
Below is a short description of the content of each file:
- test_complex_01.json: input JSON document
- test_complex_01.expected: flattened JSON element tree used to check if
parsing was corrected.
- test_complex_01.actual: flattened JSON element tree produced by
jsontest.exe from reading test_complex_01.json
- test_complex_01.rewrite: JSON document written by jsontest.exe using the
Json::Value parsed from test_complex_01.json and serialized using
Json::StyledWritter.
- test_complex_01.actual-rewrite: flattened JSON element tree produced by
jsontest.exe from reading test_complex_01.rewrite.
test_complex_01.process-output: jsontest.exe output, typically useful to
understand parsing error.
没有合适的资源?快使用搜索试试~ 我知道了~
jsoncpp-src-0.5.0.tar.gz
5星 · 超过95%的资源 需积分: 50 81 下载量 165 浏览量
2015-08-01
16:01:51
上传
评论
收藏 105KB GZ 举报
温馨提示
共173个文件
json:78个
expected:42个
py:15个
jsoncpp-src-0.5.0.tar.gz,很好的源码
资源推荐
资源详情
资源评论
收起资源包目录
jsoncpp-src-0.5.0.tar.gz (173个子文件)
AUTHORS 49B
json_value.cpp 38KB
json_reader.cpp 20KB
json_writer.cpp 20KB
jsontest.cpp 13KB
main.cpp 7KB
main.cpp 6KB
jsoncpp.dox 4KB
roadmap.dox 2KB
test_large_01.expected 31KB
test_string_02.expected 2KB
test_array_05.expected 977B
test_complex_01.expected 358B
test_array_06.expected 190B
test_comment_01.expected 109B
test_string_01.expected 98B
test_object_03.expected 54B
test_array_04.expected 46B
test_array_03.expected 46B
test_string_unicode_05.expected 34B
test_preserve_comment_01.expected 27B
test_object_02.expected 19B
test_real_07.expected 18B
test_real_06.expected 18B
test_real_05.expected 17B
test_real_02.expected 17B
test_basic_03.expected 17B
test_real_03.expected 17B
test_real_01.expected 16B
test_real_04.expected 15B
test_integer_02.expected 15B
test_integer_01.expected 14B
test_basic_04.expected 14B
test_integer_03.expected 14B
test_array_02.expected 14B
test_object_04.expected 14B
test_basic_02.expected 14B
test_basic_01.expected 13B
test_basic_07.expected 11B
test_basic_08.expected 10B
test_basic_05.expected 10B
test_string_unicode_04.expected 10B
test_basic_06.expected 10B
test_basic_09.expected 10B
test_string_unicode_03.expected 9B
test_string_unicode_02.expected 8B
test_integer_04.expected 7B
test_string_unicode_01.expected 7B
test_integer_05.expected 7B
test_array_01.expected 6B
test_object_01.expected 6B
value.h 33KB
jsontest.h 9KB
reader.h 6KB
writer.h 6KB
json_batchallocator.h 4KB
config.h 2KB
features.h 1KB
forwards.h 735B
autolink.h 438B
json.h 200B
footer.html 572B
header.html 565B
doxyfile.in 64KB
json_internalmap.inl 16KB
json_internalarray.inl 12KB
json_valueiterator.inl 7KB
test_large_01.json 9KB
test_string_02.json 2KB
pass1.json 1KB
test_array_05.json 387B
test_complex_01.json 264B
test_preserve_comment_01.json 220B
test_array_06.json 176B
test_comment_01.json 158B
pass3.json 148B
test_string_01.json 100B
test_real_03.json 74B
test_real_02.json 74B
test_object_03.json 69B
test_real_01.json 65B
fail1.json 60B
fail10.json 58B
pass2.json 52B
fail18.json 50B
fail13.json 43B
fail32.json 40B
fail26.json 38B
test_integer_03.json 37B
fail3.json 37B
test_integer_02.json 36B
test_integer_01.json 35B
fail17.json 34B
fail15.json 34B
test_basic_09.json 33B
fail22.json 33B
test_real_07.json 32B
fail21.json 32B
test_real_06.json 31B
fail12.json 31B
共 173 条
- 1
- 2
资源评论
- XUqq5212019-09-18可以使用,大家放心下载
- qq_321294252019-04-08好用的,谢谢
- lsrnature2016-01-19不错,挺好用的。
- lavender2332017-09-04导入,可以使用,谢谢了
gocpplua
- 粉丝: 457
- 资源: 72
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功