Erbsland Configuration Language Parser for C++ Documentation

Welcome to the reference implementation of the Erbsland Configuration Language Parser—a modern and robust configuration parser built for C++20 and beyond. This implementation is designed to be secure, minimal in dependencies, and easy to integrate into your existing projects.

All you need is a C++20-compliant compiler and the standard library. That’s it—no external dependencies, no hassle.

Get Started with the Tutorial →

Topics

How to Use the Parser

Learn how to integrate the parser into your application, compile it, and run its unit tests with ease.

Usage

Step-by-Step Tutorial

Follow a hands-on guide to build a small application using the parser and explore its API in depth.

Getting Started

Configuration Language Documentation

Dive into the formal documentation of the Erbsland Configuration Language to understand its syntax and features.

https://config-lang.erbsland.dev

API Reference

Access detailed reference material on all classes, methods, and core components of the parser’s API.

Reference

Requirements

Review the technical requirements and environment setup needed to get started with the parser.

Requirements

License

Familiarize yourself with the terms of use under the Apache 2.0 license.

License

Contents at a Glance

• Usage
• Getting Started
  • The Project Structure
    • Organizing Your Project
    • Getting Started: Creating the Structure
    • The Current Project State
  • The CMake Configuration
    • Writing the Main CMake File
    • Setting Up the Application CMake File
    • The Current Project State
  • Write a Minimal Main Function
    • Code Breakdown
    • The Current Project State
  • Compile and Run the Application
    • Writing a Sample Configuration
    • Run the Application with the Configuration
  • Provoking Some Errors
    • Missing Values
    • Wrong Type
    • Syntax Error
    • Recap
  • Write an Initial Game Version
    • Geometry Classes
    • The Canvas
    • The World
    • Game Logic
    • Using the Game Classes
    • Replacing the Old Main Function
    • Adding the New Files to CMake
    • Recap
  • Compile and Run Our Game
    • The Gameplay
    • Recap
  • Make the Field Configurable
    • Updates to the Game Framework
    • Reading the Section List from the Configuration
    • Compile and Run the Updated Game
    • Recap
  • Using Value Lists
    • Improving our Configuration Logic
    • Compile and Run the Updated Game
    • Recap
  • The Next Steps
    • What to Read Next?
• Reference
  • Alphabetical List
  • By Topic
• Contributing Guidelines
  • Code of Conduct
  • How You Can Contribute
  • Pull Requests
  • About the Use of Artificial Intelligence
• Requirements
  • Code-Level Requirements
  • Build Requirements
  • Test Requirements
• Goals
  • Overview
  • Full Feature Coverage
  • Secure by Design
  • Dependency-Free
  • Modern, Readable C++
  • Robustness Over Performance
• License

Indices and Tables

• Index

• Module Index

• Search Page