PullupDev/README.md at 6ecf99d19a9304e70bbd5eeee37df68a9d66bb14

【主	题】：不从配置文件远端获取 ArduinoJson库 添加到根目录调用
【描	述】：
	[原因]：防止版本不同 造成bug
	[过程]：
	[影响]：
【结	束】

# 类型 包含:
# feat：新功能（feature）
# fix：修补bug
# docs：文档（documentation）
# style： 格式（不影响代码运行的变动）
# refactor：重构（即不是新增功能，也不是修改bug的代码变动）
# test：增加测试
# chore：构建过程或辅助工具的变动

2024-07-03 13:46:41 +08:00

12 KiB

Raw Blame History

ArduinoJson is a C++ JSON library for Arduino and IoT (Internet Of Things).

Features

JSON deserialization
- Optionally decodes UTF-16 escape sequences to UTF-8
- Optionally stores links to the input buffer (zero-copy)
- Optionally supports comments in the input
- Optionally filters the input to keep only desired values
- Supports single quotes as a string delimiter
- Compatible with NDJSON and JSON Lines
JSON serialization
- Can write to a buffer or a stream
- Optionally indents the document (prettified JSON)
MessagePack serialization
MessagePack deserialization
Efficient
Versatile
- Supports custom allocators (to use external RAM chip, for example)
- Supports String, std::string, and std::string_view
- Supports Stream and std::istream/std::ostream
- Supports Flash strings
- Supports custom readers and custom writers
- Supports custom converters
Portable
- Usable on any C++ project (not limited to Arduino)
- Compatible with C++98, C++11, C++14 and C++17
- Zero warnings with -Wall -Wextra -pedantic and /W4
- Header-only library
- Works with virtually any board
  - Arduino boards: Uno, Due, Micro, Nano, Mega, Yun, Leonardo...
  - Espressif chips: ESP8266, ESP32
  - Lolin (WeMos) boards: D1 mini, D1 Mini Pro...
  - Teensy boards: 4.0, 3.2, 2.0
  - Particle boards: Argon, Boron, Electron, Photon...
  - Texas Instruments boards: MSP430...
  - Soft cores: Nios II...
- Tested on all major development environments
- Even works with online compilers like wandbox.org
- CMake friendly
Well designed
- Elegant API
- Thread-safe
- Self-contained (no external dependency)
- const friendly
- for friendly
- TMP friendly
- Handles integer overflows
Well tested
- Unit test coverage close to 100%
- Continuously tested on
- Continuously fuzzed with Google OSS Fuzz
- Passes all default checks of clang-tidy
Well documented
- Tutorials
- Examples
- How-tos
- FAQ
- Troubleshooter
- Book
- Changelog
Vibrant user community
- Most popular of all Arduino libraries on GitHub
- Used in hundreds of projects
- Responsive support
- Discord server

Quickstart

Deserialization

Here is a program that parses a JSON document with ArduinoJson.

char json[] = "{\"sensor\":\"gps\",\"time\":1351824120,\"data\":[48.756080,2.302038]}";

DynamicJsonDocument doc(1024);
deserializeJson(doc, json);

const char* sensor = doc["sensor"];
long time          = doc["time"];
double latitude    = doc["data"][0];
double longitude   = doc["data"][1];

See the tutorial on arduinojson.org

Serialization

Here is a program that generates a JSON document with ArduinoJson:

DynamicJsonDocument doc(1024);

doc["sensor"] = "gps";
doc["time"]   = 1351824120;
doc["data"][0] = 48.756080;
doc["data"][1] = 2.302038;

serializeJson(doc, Serial);
// This prints:
// {"sensor":"gps","time":1351824120,"data":[48.756080,2.302038]}