1. यह क्या है और क्यों ज़रूरी है?

C++ में, एनम (enum और enum class) नामित कॉन्स्टेंट बनाने का एक शक्तिशाली तरीका है, लेकिन इसमें एक बड़ी कमी है — इसमें बिल्ट-इन रिफ्लेक्शन नहीं है। स्टैंडर्ड C++ में एनम वैल्यू का स्ट्रिंग रूप पाने, सभी एलिमेंट्स को इटरेट करने या विकल्पों की संख्या जानने का कोई आसान तरीका नहीं है। डेवलपर्स को मैन्युअली हेल्पर फंक्शन, मैक्रोज़ या थर्ड-पार्टी कोड जनरेटर का उपयोग करना पड़ता है, जिससे कोड डुप्लीकेशन और त्रुटियाँ होती हैं।

magic_enum लाइब्रेरी इस समस्या को हल करती है। यह कंपाइल-टाइम और रन-टाइम पर एनम के साथ काम करने के लिए शक्तिशाली और सुविधाजनक टूल्स प्रदान करती है। यह C++17 टेम्पलेट्स और कंपाइलर की आंतरिक तकनीकों (जैसे __PRETTY_FUNCTION__) का उपयोग करके एनम के बारे में जानकारी अपने आप निकालती है। magic_enum की मदद से आप किसी भी वैल्यू का स्ट्रिंग नाम पा सकते हैं, स्ट्रिंग को वैल्यू में बदल सकते हैं, सभी एनम एलिमेंट्स को इटरेट कर सकते हैं, उनकी संख्या जान सकते हैं — बिना कोई अतिरिक्त कोड लिखे।

यह लाइब्रेरी लॉगिंग, सीरियलाइज़ेशन/डी-सीरियलाइज़ेशन, कॉन्फ़िगरेशन फ़ाइलें बनाने, यूज़र इनपुट पार्स करने, टेस्टिंग और ऐसे किसी भी काम के लिए ज़रूरी है जहाँ एनम के साथ डायनामिक रूप से काम करना हो। यह कोड को साफ, सुरक्षित बनाती है और बॉयलरप्लेट कोड को काफी कम करती है। magic_enum C++ में enum रिफ्लेक्शन के लिए सबसे लोकप्रिय और परिपक्व लाइब्रेरी है, जो सभी प्रमुख कंपाइलरों (GCC, Clang, MSVC) पर काम करती है।

2. इंस्टॉलेशन

magic_enum एक header-only लाइब्रेरी है, यानी इसमें सिर्फ एक हेडर फ़ाइल है। इससे इसे इंस्टॉल करना बहुत आसान है। आपको इसे अलग से बिल्ड करने की ज़रूरत नहीं है, बस magic_enum.hpp फ़ाइल को अपने प्रोजेक्ट में कॉपी करें और इसे इन्क्लूड करें।

हालांकि, डिपेंडेंसी मैनेजमेंट के लिए CMake (FetchContent या find_package के ज़रिए) या vcpkg, Conan जैसे पैकेज मैनेजर का उपयोग करना बेहतर है।

तरीका 1: मैन्युअली फ़ाइल डाउनलोड करें (सबसे आसान)

1. GitHub रिलीज़ पेज पर जाएँ: https://github.com/Neargye/magic_enum/releases
2. magic_enum.hpp फ़ाइल का नवीनतम वर्शन डाउनलोड करें।
3. इसे अपने प्रोजेक्ट फ़ोल्डर में रखें (जैसे, include/ फ़ोल्डर में)।
4. कोड में इसे इन्क्लूड करें: #include "magic_enum.hpp"

तरीका 2: vcpkg के ज़रिए (Windows के लिए अनुशंसित)

vcpkg install magic-enum

तरीका 3: Conan के ज़रिए

conan install magic_enum/0.9.5@

तरीका 4: CMake FetchContent के ज़रिए (नए प्रोजेक्ट्स के लिए अनुशंसित)

अपने CMakeLists.txt में यह कोड जोड़ें:

include(FetchContent)
FetchContent_Declare(
  magic_enum
  GIT_REPOSITORY https://github.com/Neargye/magic_enum.git
  GIT_TAG v0.9.5 # या नवीनतम स्थिर टैग
)
FetchContent_MakeAvailable(magic_enum)

target_link_libraries(your_target PRIVATE magic_enum::magic_enum)

महत्वपूर्ण: magic_enum के लिए C++17 सपोर्ट करने वाला कंपाइलर ज़रूरी है। सुनिश्चित करें कि आपने अपने प्रोजेक्ट में उपयुक्त स्टैंडर्ड चालू किया है (जैसे, set(CMAKE_CXX_STANDARD 17) या फ़्लैग -std=c++17)।

3. तुरंत शुरुआत — एक छोटा काम का उदाहरण

चलिए सबसे आसान