jbeder/yaml-cpp
Yaml Cpp
yaml-cpp is a C++ library for parsing and emitting YAML 1.2 documents. It provides a complete YAML processing pipeline, from reading YAML content into a traversable node tree to writing in-memory data structures back as YAML text.
The library represents parsed YAML as a mutable tree of typed nodes, supporting scalars, sequences, maps, and aliases. It uses a recursive-descent parser to build this node tree, and a stream-based emitter to generate YAML output incrementally. Template-based type conversion enables compile-time serialization between YAML nodes and C++ types, including support for custom user-defined structs and standard STL containers.
For output formatting, the library offers manipulator-driven control over flow style, block style, comments, and anchors. It includes null-safe node access that returns default values for missing keys, and supports ASCII-only output mode that escapes all non-ASCII characters. The library also provides emitter error detection to catch malformed output during emission.
Features
- YAML Libraries - A C++ library for parsing and emitting YAML 1.2 documents with nested structures and custom types.
- Node-Tree Data Models - Represents parsed YAML as a mutable tree of typed nodes supporting traversal and in-place editing.
- YAML Node Values - Extracts typed data from a node and assigns new values for round-trip editing.
- Collection Iteration - Exposes YAML sequences and maps through standard C++ iterators for element traversal.
- YAML Stream Emitters - Generates YAML output incrementally through a stream abstraction that accepts manipulator commands.
- Recursive Descent Parsers - Parses YAML tokens by recursively descending through grammar rules to build a typed node tree.
- YAML Data Serialization - Emits in-memory C++ data structures as YAML 1.2 formatted text.
- YAML Structure Builders - Constructs hierarchical YAML structures by nesting sequence and map manipulators.
- YAML Structure Builders - Constructs nested maps, sequences, scalars, and aliases from scratch using bracket and push operations.
- Compile-Time Serialization - Converts between YAML nodes and C++ types using template specializations for compile-time serialization.
- YAML Node Conversions - Specializes a conversion template to encode and decode user-defined structs as YAML nodes.
- Multi-Document YAML Parsing - Loads YAML 1.2 documents into a traversable node tree for programmatic access.
- YAML Serializers - Writes C++ data structures as YAML 1.2 formatted text for storage or transmission.
- Streaming Emitters - Writes YAML output incrementally using stream manipulators to produce structured text.
- Output Format Manipulators - Provides manipulator-driven control over flow style, block style, comments, and anchors in YAML output.
- YAML Format Modifiers - Applies formatting modifiers like literal blocks, flow style, comments, and anchors to customize YAML output.
- YAML Output Format Modifiers - Applies formatting modifiers like literal blocks, flow style, comments, and anchors to customize YAML output.
- YAML Node Types - Queries whether a node is a scalar, sequence, map, null, or undefined to handle heterogeneous data safely.
- Template-Based Type Serializers - Provides template-based compile-time serialization for custom C++ structs to YAML nodes.
- STL Container Outputs - Outputs standard C++ vectors, lists, and maps directly as YAML sequences or mappings.
- XML and YAML Node Navigation - Builds, inspects, and modifies hierarchical YAML structures using sequences, maps, and scalars.
- Default Value Returns - Provides null-safe node access that returns default values for missing keys during YAML traversal.
- AI & Machine Learning - YAML parser and emitter
- Serialization and Parsing - Parser and emitter for YAML data.
- Data Serialization - YAML parser and emitter for C++.
