feedc0de/ArduinoJson
1
0
Fork 0
forked from bblanchon/ArduinoJson
Code Pull Requests Activity

Remplaced char* by char[]

Browse Source
This commit is contained in:
Benoit Blanchon
2014-02-27 13:59:06 +01:00
parent c844db8659
commit 8c2a1fab72
2 changed files with 6 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
CHANGELOG.md
View File

@ -4,7 +4,7 @@ ArduinoJsonParser change log
v1.1 (unreleased) v1.1 (unreleased)
---- ----
* Example: changed `char* json` into `char[] json` so that the byes are not write protected * Example: changed `char* json` into `char json[]` so that the byes are not write protected
* Fixed parsing bug when the JSON contains multi-dimensional arrays * Fixed parsing bug when the JSON contains multi-dimensional arrays
v1.0 v1.0

10
README.md
View File

@ -21,7 +21,7 @@ Features
Example Example
------- -------
char* json = "{\"Name\":\"Blanchon\",\"Skills\":[\"C\",\"C++\",\"C#\"],\"Age\":32,\"Online\":true}"; char json[] = "{\"Name\":\"Blanchon\",\"Skills\":[\"C\",\"C++\",\"C#\"],\"Age\":32,\"Online\":true}";
JsonParser<32> parser; JsonParser<32> parser;
@ -66,7 +66,7 @@ To extract data from the JSON string, you need to create a `JsonParser`, and spe
> #### How to choose the number of tokens ? > #### How to choose the number of tokens ?
> A token is an element of the JSON object: either a key, a value, an hash-table or an array. > A token is an element of the JSON object: either a key, a value, an hash-table or an array.
> As an example the `char* json` on the top of this page contains 12 tokens (don't forget to count 1 for the whole object and 1 more for the array itself). > As an example the `char json[]` on the top of this page contains 12 tokens (don't forget to count 1 for the whole object and 1 more for the array itself).
> The more tokens you allocate, the more complex the JSON can be, but also the more memory is occupied. > The more tokens you allocate, the more complex the JSON can be, but also the more memory is occupied.
> Each token takes 8 bytes, so `sizeof(JsonParser<32>)` is 256 bytes which is quite big in an Arduino with only 2KB of RAM. > Each token takes 8 bytes, so `sizeof(JsonParser<32>)` is 256 bytes which is quite big in an Arduino with only 2KB of RAM.
@ -85,7 +85,7 @@ If you need other type, you can get the string value and parse it yourself.
#### Hash-table #### Hash-table
Consider we have a `char* json` pointing to the following JSON string: Consider we have a `char json[]` containing to the following JSON string:
{ {
"Name":"Blanchon", "Name":"Blanchon",
@ -120,7 +120,7 @@ And then extract the member you need:
#### Array #### Array
Consider we have a `char* json` pointing to the following JSON string: Consider we have a `char json[]` containing to the following JSON string:
[ [
[ 1.2, 3.4 ], [ 1.2, 3.4 ],
@ -196,7 +196,7 @@ because the local variable `parser` will be *removed* from memory when the funct
This will probably never be an issue, but you need to be aware of this feature. This will probably never be an issue, but you need to be aware of this feature.
When you pass a `char*` to `JsonParser::parseArray()` or `JsonParser::parseHashTable()`, the content of the string will be altered to add `\0` at the end of the tokens. When you pass a `char[]` to `JsonParser::parseArray()` or `JsonParser::parseHashTable()`, the content of the string will be altered to add `\0` at the end of the tokens.
This is because we want functions like `JsonArray::getString()` to return a null-terminating string without any memory allocation. This is because we want functions like `JsonArray::getString()` to return a null-terminating string without any memory allocation.