Updated FAQ (markdown)

Benoît Blanchon
2016-09-11 09:21:05 +02:00
parent df4e15bc6e
commit 0832377022

57
FAQ.md

@ -1,33 +1,34 @@
### Table of content:
<!-- MarkdownTOC depth=3 autolink=true bracket=round lowercase_only_ascii=true -->
* [Part 1 - Common questions](#part-1---common-questions)
* [Compilation fails? Device crashes? Nothing on serial console?](#compilation-fails-device-crashes-nothing-on-serial-console)
* [Why does my device crash or reboot?](#why-does-my-device-crash-or-reboot)
* [What are the differences between `StaticJsonBuffer` and `DynamicJsonBuffer`?](#what-are-the-differences-between-staticjsonbuffer-and-dynamicjsonbuffer)
* [How to determine the buffer size?](#how-to-determine-the-buffer-size)
* [What are the common sizes for JsonBuffer?](#what-are-the-common-sizes-for-jsonbuffer)
* [I found a memory leak in the library!](#i-found-a-memory-leak-in-the-library)
* [Why shouldn't I use a global `JsonBuffer`?](#why-shouldnt-i-use-a-global-jsonbuffer)
* [How to reuse a `JsonBuffer`?](#how-to-reuse-a-jsonbuffer)
* [What's the best way to use the library?](#whats-the-best-way-to-use-the-library)
* [How to write a function that works with both `JsonArray` and `JsonObject`?](#how-to-write-a-function-that-works-with-both-jsonarray-and-jsonobject)
* [How to assign a `JsonArray` or `JsonObject`?](#how-to-assign-a-jsonarray-or-jsonobject)
* [Part 2 - Serialization questions](#part-2---serialization-questions)
* [How to compute the JSON length?](#how-to-compute-the-json-length)
* [How to create complex nested objects?](#how-to-create-complex-nested-objects)
* [The first serialization succeeds, why do the next ones fail?](#the-first-serialization-succeeds-why-do-the-next-ones-fail)
* [Why ArduinoJson is slow?](#why-arduinojson-is-slow)
* [Part 3 - Deserialization questions](#part-3---deserializationparsing-questions)
* [Can I parse data from a stream?](#can-i-parse-data-from-a-stream)
* [Can I parse a JSON input that is too big to fit in memory?](https://github.com/bblanchon/ArduinoJson/wiki/FAQ#can-i-parse-a-json-input-that-is-too-big-to-fit-in-memory)
* [Should I call `parseArray()` or `parseObject()`?](#should-i-call-parsearray-or-parseobject)
* [Why parsing fails?](#why-parsing-fails)
* [The first parsing succeeds, why do the next ones fail?](#the-first-parsing-succeeds-why-do-the-next-ones-fail)
* [Parsing succeeds but I can't read the values!](#parsing-succeeds-but-i-cant-read-the-values)
* [How to know the type of a value?](#how-to-know-the-type-of-a-value)
* [Can I access to object member by its index, instead of its key?](#can-i-access-to-object-member-by-its-index-instead-of-its-key)
* [How to fix error "Ambiguous overload for 'operator='"](#how-to-fix-error-ambiguous-overload-for-operator)
- [Part 1 - Common questions](#part-1---common-questions)
- [Compilation fails? Device crashes? Nothing on serial console?](#compilation-fails-device-crashes-nothing-on-serial-console)
- [Why does my device crash or reboot?](#why-does-my-device-crash-or-reboot)
- [What are the differences between `StaticJsonBuffer` and `DynamicJsonBuffer`?](#what-are-the-differences-between-staticjsonbuffer-and-dynamicjsonbuffer)
- [How to determine the buffer size?](#how-to-determine-the-buffer-size)
- [What are the common sizes for JsonBuffer?](#what-are-the-common-sizes-for-jsonbuffer)
- [I found a memory leak in the library!](#i-found-a-memory-leak-in-the-library)
- [Why shouldn't I use a global `JsonBuffer`?](#why-shouldnt-i-use-a-global-jsonbuffer)
- [How to reuse a `JsonBuffer`?](#how-to-reuse-a-jsonbuffer)
- [What's the best way to use the library?](#whats-the-best-way-to-use-the-library)
- [How to write a function that works with both `JsonArray` and `JsonObject`?](#how-to-write-a-function-that-works-with-both-jsonarray-and-jsonobject)
- [How to assign a `JsonArray` or `JsonObject`?](#how-to-assign-a-jsonarray-or-jsonobject)
- [Part 2 - Serialization questions](#part-2---serialization-questions)
- [How to compute the JSON length?](#how-to-compute-the-json-length)
- [How to create complex nested objects?](#how-to-create-complex-nested-objects)
- [The first serialization succeeds, why do the next ones fail?](#the-first-serialization-succeeds-why-do-the-next-ones-fail)
- [Why ArduinoJson is slow?](#why-arduinojson-is-slow)
- [Part 3 - Deserialization/parsing questions](#part-3---deserializationparsing-questions)
- [Can I parse data from a stream?](#can-i-parse-data-from-a-stream)
- [Can I parse a JSON input that is too big to fit in memory?](#can-i-parse-a-json-input-that-is-too-big-to-fit-in-memory)
- [Should I call `parseArray\(\)` or `parseObject\(\)`?](#should-i-call-parsearray-or-parseobject)
- [Why parsing fails?](#why-parsing-fails)
- [The first parsing succeeds, why do the next ones fail?](#the-first-parsing-succeeds-why-do-the-next-ones-fail)
- [Parsing succeeds but I can't read the values!](#parsing-succeeds-but-i-cant-read-the-values)
- [How to know the type of a value?](#how-to-know-the-type-of-a-value)
- [Can I access to object member by its index, instead of its key?](#can-i-access-to-object-member-by-its-index-instead-of-its-key)
- [How to fix error "Ambiguous overload for 'operator='"](#how-to-fix-error-ambiguous-overload-for-operator)
<!-- /MarkdownTOC -->
## Part 1 - Common questions