xmlio

xmlio is a C++23 library for reading, querying, writing, and composing structured XML. The manual begins with ordinary application use, develops the serialization model in small examples, and leaves migration details and the complete API reference for later chapters.

Contents

• 1. Overview and Quick Start
  • 1.1. Purpose
  • 1.2. Requirements
  • 1.3. Build and test
  • 1.4. First round trip
  • 1.5. Choosing an input constructor
  • 1.6. Where to continue
• 2. Reading XML
  • 2.1. Input sources
  • 2.2. Paths and scalar reads
  • 2.3. Subreaders
  • 2.4. Attributes
  • 2.5. Queries and optional values
  • 2.6. Repeated siblings
  • 2.7. Reader diagnostics and mutation
  • 2.8. Complete XPath example
• 3. Writing XML
  • 3.1. Memory and file writers
  • 3.2. Creating the document tree
  • 3.3. Attributes and empty elements
  • 3.4. Namespaces
  • 3.5. Text, escaping, and raw XML
  • 3.6. Embedding documents
  • 3.7. Serialization and output
  • 3.8. Complete composition example
• 4. Types and XML Representations
  • 4.1. Representation summary
  • 4.2. Scalar values
  • 4.3. Complex numbers
  • 4.4. Sequential containers
  • 4.5. Pairs and maps
  • 4.6. Optional values
  • 4.7. Repeated siblings
• 5. User-Defined Types
  • 5.1. Serialization by ordinary functions
  • 5.2. Required and optional fields
  • 5.3. Enums and readable XML
  • 5.4. Validation belongs to the type
  • 5.5. Nested and associative records
• 6. XPath and XML Composition
  • 6.1. Useful XPath forms
  • 6.2. Namespaces
  • 6.3. Deferred typed groups
  • 6.4. Subtree extraction and provenance
  • 6.5. XML as metadata
  • 6.6. Combining catalogs
• 7. Errors and Application Design
  • 7.1. Exception hierarchy
  • 7.2. Schema versions
  • 7.3. Required fields and unknown fields
  • 7.4. Application boundaries
  • 7.5. Security and ownership
• 8. Building and Integration
  • 8.1. CMake options
  • 8.2. Complete developer build
  • 8.3. HTML-only builds
  • 8.4. Example programs
  • 8.5. Installation
  • 8.6. Consuming the package
• 9. API Reference
  • xmlio
• 10. ADAT XML compatibility
  • 10.1. Implemented in the core package
  • 10.2. Deliberate modernization
  • 10.3. Important behavioral differences
  • 10.4. Compatibility adapters not in the core
• 11. License