bblanchon/ArduinoJson

Features

• Embedded Serialization Utilities - Provides memory-optimized serialization utilities for converting structured data to JSON or MessagePack on embedded systems.
• JSON Parsing - Reads JSON strings and converts them into structured data objects for programmatic access on microcontrollers.
• Bracket Notation Accessors - Enables retrieval of nested values from parsed JSON documents using array-style bracket syntax.
• JSON Serializers - Provides utilities to convert structured memory objects into compact JSON strings for transmission or storage.
• Incremental JSON Parsing - Reads JSON data incrementally from I/O streams such as serial or network interfaces.
• MessagePack Serializers - Encodes structured documents into compact MessagePack binary streams.
• JSON Array Iteration - Allows looping through JSON array elements by holding a reference to the array within the document.
• JSON Construction Utilities - Provides tools for building structured JSON documents in memory to prepare them for serialization.
• JSON Object Iteration - Enumerates all key-value pairs in a JSON object using iterators or loops.
• Embedded JSON Parsing - Implements high-efficiency JSON parsing specifically designed for microcontrollers with limited RAM.
• Binary Data Encoding - Supports MessagePack as a compact binary encoding for efficient data exchange in constrained environments.
• JSON Serialization - Converts stored JSON documents into minified or indented strings for output to buffers.
• Stream Parsing Utilities - Processes incoming data chunks from communication streams to reconstruct JSON documents.
• Embedded Memory Management - Controls RAM usage through pool-based allocation, string deduplication, and flash memory storage to fit constrained hardware.
• Fixed-Pool Allocators - Implements a fixed-size memory pool for document storage to avoid dynamic heap fragmentation.
• Flash Memory String Referencing - Reads constant strings directly from program flash memory to conserve volatile system RAM.
• String Deduplication - Reduces RAM consumption by storing only one instance of identical keys or values within a document.
• Implicit Type Casting - Automatically converts parsed JSON values to native C++ types without requiring explicit casting.
• JSON Key Listing - Iterates over all keys present in a JSON object and returns them for further processing.
• Stream-Based Serialization - Implements serialization of internal data structures directly to output streams for efficient transmission.
• Type Conversion and Casting - Uses C++ templates to automatically map JSON values to native types via implicit or explicit casting.
• Zero-Copy String Views - Utilizes non-owning string views to reference existing buffers and avoid redundant memory allocations.
• JSON - Evaluates equality or order between two JSON variants by analyzing their types.
• Parsing Behavior Configurations - Adjusts the handling of Unicode, comments, and nesting depth to meet application requirements.
• Binary Data Accessors - Provides direct reading and writing of raw binary data embedded within MessagePack streams.
• Binary Size Calculation - Determines the serialized byte size of a MessagePack binary without executing the full conversion.
• Custom Type Converters - Allows user-defined C++ types to be serialized and deserialized via custom converters.
• Cast Range Validations - Validates that numeric values fit within the target integer type before performing a cast to prevent overflow.
• Streaming I/O - Reads and writes JSON data directly to byte stream interfaces like serial ports and files.
• Custom JSON Output Writers - Defines a custom output class to control how serialized bytes are written to hardware or buffers.
• Pre-Measurement Serializations - Calculates the exact byte length of a JSON string before performing the actual serialization.
• Custom Type Converters - ArduinoJson registers serialization and deserialization rules for user-defined or third-party data types.
• Deserialization Discarding - Minimizes memory usage by discarding unwanted JSON keys during the deserialization process.
• JSON Document Storage - Enables the persistence of JSON documents into non-volatile EEPROM memory.
• JSON Object Merging - Combines two or more JSON objects into a single document by copying key-value pairs.
• Non-Standard Parsers - Accepts non-standard JSON extensions, including single-quoted strings and comments, during parsing.
• Memory Footprint Optimizers - Optimizes the memory footprint of JSON documents by tuning byte sizes for identifiers and string lengths.
• Parsing Exception Handling - Detects invalid input or memory exhaustion by checking the return status of parsing functions.
• Recursive JSON Search - Recursively traverses nested JSON documents to locate specific keys and their associated values.
• Local Filesystem Storage - Allows application settings stored as JSON documents to be persisted on a local filesystem.
• Custom JSON Input Readers - Defines a custom byte-reading interface to ingest JSON data from non-standard input sources.
• Response Body Parsing - Converts the raw body of an incoming HTTP response into a structured JSON document.
• Embedded Communication Libraries - Facilitates the exchange of JSON payloads over HTTP and UDP network protocols in IoT contexts.
• Custom Memory Allocators - Allows users to define custom allocators to manage data placement, such as using external PSRAM.
• Hardware Integration Streams - Provides support for environment-specific streams and strings to integrate seamlessly with target hardware.
• Binary Size Optimizations - Reduces the final binary footprint by removing Unicode decoding support at compile time.
• Program Memory String Storage - Reads constant strings directly from program flash memory instead of volatile RAM to conserve space.
• Sequential - ArduinoJson reads one complete JSON document at a time from a stream to support line-delimited formats.
• C-Array Synchronization - Transfers values between C arrays and JSON arrays in either direction.
• Extraction Error Handlers - Returns default values when requested fields are missing or have unexpected types to handle extraction failures.
• Protocol I/O Decoupling - Decouples JSON processing from hardware protocols using abstract reader and writer interfaces.
• JSON Syntax Validators - Validates that input strings or streams contain syntactically correct JSON before parsing.
• Symmetric Data Models - Uses a shared internal representation to support both JSON and MessagePack binary formats.
• Parsing Field Filters - Discards unwanted keys during parsing to minimize the memory footprint of the resulting document.
• Development Libraries - JSON library optimized for embedded systems.

Star history