1. Qu'est-ce que c'est et pourquoi l'utiliser ?

En C++, les énumérations (enum et enum class) sont un outil puissant pour créer des constantes nommées. Cependant, elles souffrent d'un défaut majeur : l'absence de réflexion intégrée. Le C++ standard n'offre aucun moyen simple d'obtenir la représentation textuelle d'une valeur d'énumération, de parcourir tous ses éléments ou de connaître le nombre de variantes. Les développeurs doivent écrire manuellement des fonctions auxiliaires, des macros ou utiliser des générateurs de code externes, ce qui entraîne une duplication de code et des erreurs.

La bibliothèque magic_enum résout ce problème en fournissant un ensemble d'outils puissants et pratiques pour travailler avec les énumérations, à la fois à la compilation et à l'exécution. Elle utilise la magie des templates C++17 et des mécanismes internes du compilateur (comme __PRETTY_FUNCTION__) pour extraire automatiquement les informations sur les énumérations. Avec magic_enum, vous pouvez obtenir le nom textuel de n'importe quelle valeur, convertir une chaîne en valeur, parcourir tous les éléments d'une énumération, connaître leur nombre, et bien plus encore, sans avoir à écrire de code auxiliaire.

Cette bibliothèque est indispensable pour la journalisation, la sérialisation/désérialisation, la création de fichiers de configuration, l'analyse de la saisie utilisateur, les tests et toute autre tâche nécessitant un travail dynamique avec les énumérations. Elle rend le code plus propre, plus sûr et réduit considérablement le volume de code passe-partout. magic_enum est sans doute la bibliothèque de réflexion d'énumérations la plus populaire et la plus mature en C++, prise en charge par tous les compilateurs majeurs (GCC, Clang, MSVC).

2. Installation

magic_enum est une bibliothèque header-only, composée d'un seul fichier d'en-tête. Cela rend son installation incroyablement simple. Vous n'avez pas besoin de la compiler comme une bibliothèque séparée ; il suffit de copier le fichier magic_enum.hpp dans votre projet et de l'inclure.

Cependant, pour une gestion pratique des dépendances, il est recommandé d'utiliser des systèmes de build comme CMake (via FetchContent ou find_package) ou des gestionnaires de paquets comme vcpkg ou Conan.

Méthode 1 : Téléchargement manuel du fichier (la plus simple)

1. Rendez-vous sur la page des releases GitHub : https://github.com/Neargye/magic_enum/releases
2. Téléchargez la dernière version du fichier magic_enum.hpp.
3. Placez-le dans le dossier de votre projet (par exemple, dans include/).
4. Incluez-le dans votre code : #include "magic_enum.hpp"

Méthode 2 : Via vcpkg (recommandé pour Windows)

vcpkg install magic-enum

Méthode 3 : Via Conan

conan install magic_enum/0.9.5@

Méthode 4 : Via CMake FetchContent (recommandé pour les nouveaux projets)

Ajoutez le code suivant à votre fichier CMakeLists.txt :

include(FetchContent)
FetchContent_Declare(
  magic_enum
  GIT_REPOSITORY https://github.com/Neargye/magic_enum.git
  GIT_TAG v0.9.5 # Ou le dernier tag stable
)
FetchContent_MakeAvailable(magic_enum)

target_link_libraries(votre_cible PRIVATE magic_enum::magic_enum)

Important : Pour utiliser magic_enum, vous avez besoin d'un compilateur supportant C++17. Assurez-vous d'avoir activé le standard correspondant dans votre projet (par exemple, set(CMAKE_CXX_STANDARD 17) ou le flag -std=c++17).

3. Démarrage rapide — un exemple minimal fonctionnel

Commençons par l'exemple le plus simple