Neargye/magic_enum
Magic Enum
Magic Enum is a C++ library that provides compile-time reflection for enumerations, enabling conversion between enum values and their string names, iteration over enum members, and validation of enum values without relying on macros or external code generation. It uses template metaprogramming and constexpr functions to extract enum information directly from the compiler's internal representation, making the entire reflection process static and free of runtime overhead.
The library distinguishes itself through its comprehensive set of compile-time enum utilities, including the ability to count enum elements, iterate over all values, and dispatch runtime enum values to compile-time code paths via switch-like constructs. It also supports bitwise-combined enum flags, allowing flag combinations to be decomposed into individual components and mapped to their string names, as well as enum fusion, which encodes two enum values into a single integer for multi-level switch dispatch.
Beyond its core reflection capabilities, Magic Enum offers string parsing that converts string representations back into enum values with support for case-insensitive matching, integer-to-enum conversion with validity checking, and membership validation to determine whether a given value, integer, or string belongs to an enum's set of valid members. The library is header-only and requires no additional build steps or configuration to use.
Features
- Enum Reflection - Provides compile-time reflection for C++ enums, converting values to strings and iterating members without macros.
- Compile-Time Conversions - Converts any C++ enum value to its string name at compile time using template metaprogramming.
- String-to-Enum Parsers - Parses string representations back into enum values with case-insensitive matching support.
- Enum-to-String Converters - Converts enum values to their string names at compile time without macros or runtime overhead.
- Enum Parsers - Parses string representations back into C++ enum values with case-insensitive and custom matching rules.
- String Serializations - Provides compile-time conversion between enum values and their string names without macros.
- Integer-to-Enum Converters - Converts integers to enum values with validity checking, returning optional results for invalid inputs.
- Enum Membership Validators - Validates integer-to-enum conversions using constexpr lookup, returning optional values for invalid inputs.
- Enum Switch Dispatchers - Ships a compile-time switch dispatch mechanism for mapping enum values to constexpr code paths.
- Template Specializations - Generates unique template specializations per enum type for type-safe string conversion and iteration.
- Compile-Time Enum Counters - Counts distinct enum values at compile time without macros or runtime overhead.
- Compile-Time Enum Iterators - Iterates over all enum values at compile time for code generation and static analysis.
- Compile-Time Enum Switches - Dispatches runtime enum values to compile-time code paths via constexpr lambdas.
- Enum Index Retrievers - Returns the zero-based index of an enum value within its compile-time sequence.
- Multi-Enum Dispatchers - Implements enum fusion to encode two enum values into a single integer for multi-level switch dispatch.
- Bitwise Flag Definitions - Supports bitwise-combined enum flags by decomposing integers into individual flag components and mapping them to names.
- String Conversions - Handles bitwise-combined enum flags by converting flag combinations to string names and parsing them back.
- Enum Value Sequences - Generates compile-time sequences of enum values for iteration and counting without runtime overhead.
