frozen लाइब्रेरी C++ के लिए: compile-time कंटेनरों की पूरी गाइड

frozen लाइब्रेरी C++17 और उससे नए वर्जन के लिए एक header-only लाइब्रेरी है, जो कंटेनर (map, set, string) प्रदान करती है जो पूरी तरह से compile-time पर इनिशियलाइज़ होते हैं। यह immutable (अपरिवर्तनीय) डेटा स्ट्रक्चर बनाने की अनुमति देती है, जिन्हें runtime पर डायनामिक मेमोरी आवंटन की आवश्यकता नहीं होती। यह एम्बेडेड सिस्टम, गेम इंजन, हाई-लोड सर्वर और किसी भी कोड के लिए आदर्श समाधान है जहाँ परफॉरमेंस और runtime की पूर्वानुमेयता महत्वपूर्ण है।

frozen का मुख्य विचार यह है कि आप कंटेनर को constexpr या constinit के रूप में परिभाषित करते हैं, और सॉर्टिंग, हैशिंग और डेटा स्ट्रक्चर बनाने का सारा काम compile-time पर होता है। Runtime पर आपको एक तैयार, ऑप्टिमाइज़्ड कंटेनर मिलता है जो न्यूनतम ओवरहेड के साथ काम करता है। उदाहरण के लिए, frozen::map सॉर्टेड ऐरे पर बाइनरी सर्च का उपयोग करता है, जबकि frozen::unordered_map परफेक्ट हैशिंग का उपयोग करता है, जो बिना किसी कोलिज़न के O(1) एक्सेस की गारंटी देता है।

C++ डेवलपर्स के लिए इसका मतलब है: कोई डायनामिक मेमोरी नहीं (new/delete नहीं), कोई एक्सेप्शन नहीं (noexcept), पूर्ण थ्रेड-सेफ्टी (क्योंकि डेटा केवल पढ़ने के लिए है), और माइक्रोकंट्रोलर की फ्लैश मेमोरी में कंटेनर रखने की क्षमता। इस लाइब्रेरी का उपयोग Facebook (अब Meta), कंपाइलर और ऑपरेटिंग सिस्टम कर्नेल में सक्रिय रूप से किया जाता है।

इंस्टॉलेशन

frozen लाइब्रेरी header-only है, इसलिए इंस्टॉलेशन में केवल हेडर फाइलों को आपके प्रोजेक्ट में कॉपी करना शामिल है। सबसे आसान तरीका Conan या CMake FetchContent का उपयोग करना है। नीचे विभिन्न पैकेज मैनेजरों के लिए सटीक कमांड दिए गए हैं।

Conan के माध्यम से इंस्टॉलेशन (अनुशंसित)

conan install frozen/1.1.1@ -r conancenter
# फिर CMakeLists.txt में जोड़ें:
# find_package(frozen REQUIRED)
# target_link_libraries(your_target frozen::frozen)

vcpkg के माध्यम से इंस्टॉलेशन

vcpkg install frozen
# इंस्टॉलेशन के बाद उपयोग करें:
# find_package(frozen CONFIG REQUIRED)
# target_link_libraries(your_target frozen::frozen)

CMake FetchContent के माध्यम से इंस्टॉलेशन (बिना पैकेज मैनेजर)

include(FetchContent)
FetchContent_Declare(
  frozen
  GIT_REPOSITORY https://github.com/serge-sans-paille/frozen.git
  GIT_TAG v1.1.1
)
FetchContent_MakeAvailable(frozen)
target_link_libraries(your_target frozen::frozen)

मैन्युअल इंस्टॉलेशन (header-only)

git clone https://github.com/serge-sans-paille/frozen.git
# frozen/include/frozen फोल्डर को अपने प्रोजेक्ट में कॉपी करें
# कंपाइलर में include पथ जोड़ें:
# g++ -I/path/to/frozen/include your_file.cpp -std=c++17

त्वरित शुरुआत: न्यूनतम कार्यशील उदाहरण

example.cpp नामक फाइल बनाएं और इसमें निम्नलिखित कोड डालें:

#include <iostream>
#include <frozen/unordered_map.h>
#include <frozen/string.h>

int main() {
    // परफेक्ट हैशिंग के साथ compile-time map बनाएं
    constexpr frozen::unordered_map<frozen::string, int, 3> fruit_calories = {
        {"सेब", 95},
        {"केला", 105},
        {"संतरा", 62}
    };

    // Runtime पर सर्च — O(1), बिना कोलिज़न के
    std::cout << "केले की कैलोरी: " << fruit_calories.at("केला") << "\n";

    // कुंजी की उपलब्धता जांचें
    if (auto it = fruit_calories.find("अंगूर"); it != fruit_calories.end()) {
        std::cout << "अंगूर मिला: " << it->second << "\n";
    } else {
        std::cout << "अंगूर नहीं मिला\n";
    }

    // सभी तत्वों पर इटरेट करें
    for (auto& [fruit, calories] : fruit_calories) {
        std::cout << fruit.data() << ": " << calories << " कैलोरी\n";
    }

    return 0;
}

इस उदाहरण में, fruit_calories map पूरी तरह से compile-time पर बनता है। कोई डायनामिक मेमोरी आवंटन नहीं, कोई हैशिंग ओवरहेड नहीं — बस एक तेज़, पूर्वानुमेय लुकअप।

मुख्य कंटेनर और उनके उपयोग

frozen लाइब्रेरी कई प्रकार के compile-time कंटेनर प्रदान करती है। यहाँ मुख्य कंटेनर और उनके उपयोग दिए गए हैं:

frozen::map और frozen::unordered_map

ये key-value स्टोर करने के लिए उपयोग होते हैं। frozen::map बाइनरी सर्च का उपयोग करता है, जबकि frozen::unordered_map परफेक्ट हैशिंग का उपयोग करता है। दोनों ही compile-time पर बनते हैं और runtime पर तेज़ एक्सेस प्रदान करते हैं।

frozen::set और frozen::unordered_set

ये यूनिक तत्वों के सेट के लिए उपयोग होते हैं। frozen::set सॉर्टेड ऐरे पर आधारित है, जबकि frozen::unordered_set परफेक्ट हैशिंग का उपयोग करता है।

frozen::string

यह compile-time स्ट्रिंग के लिए एक क्लास है। यह constexpr संदर्भों में उपयोग के लिए डिज़ाइन किया गया है और इसे map/set में कुंजी के रूप में उपयोग किया जा सकता है।

उन्नत उदाहरण: एम्बेडेड सिस्टम में उपयोग

एम्बेडेड सिस्टम में, मेमोरी और परफॉरमेंस की बाधाएँ महत्वपूर्ण होती हैं। frozen लाइब्रेरी का उपयोग करके, आप डायनामिक मेमोरी आवंटन से बच सकते हैं और अपने कोड को अधिक पूर्वानुमेय बना सकते हैं।

#include <frozen/map.h>
#include <frozen/string.h>

// एम्बेडेड सिस्टम में सेंसर कॉन्फ़िगरेशन
constexpr frozen::map<frozen::string, int, 4> sensor_config = {
    {"तापमान", 0x01},
    {"दबाव", 0x02},
    {"आर्द्रता", 0x03},
    {"प्रकाश", 0x04}
};

int get_sensor_id(const char* name) {
    auto it = sensor_config.find(name);
    return it != sensor_config.end() ? it->second : -1;
}

यह उदाहरण दिखाता है कि कैसे frozen::map का उपयोग करके सेंसर कॉन्फ़िगरेशन को compile-time पर परिभाषित किया जा सकता है, जिससे runtime पर कोई मेमोरी ओवरहेड नहीं होता।

निष्कर्ष

frozen लाइब्रेरी C++ डेवलपर्स के लिए एक शक्तिशाली उपकरण है जो compile-time कंटेनर प्रदान करती है। यह परफॉरमेंस-क्रिटिकल एप्लिकेशन, एम्बेडेड सिस्टम और उन परिदृश्यों के लिए आदर्श है जहाँ मेमोरी और runtime की पूर्वानुमेयता महत्वपूर्ण है। header-only डिज़ाइन और सरल API के साथ, इसे अपने प्रोजेक्ट में एकीकृत करना आसान है।

अधिक जानकारी और उदाहरणों के लिए, GitHub रिपॉजिटरी देखें।