spdlog C++: पूर्ण गाइड उदाहरणों के साथ

spdlog क्या है और इसकी आवश्यकता क्यों है?

spdlog C++ के लिए एक अत्यंत तेज़, हेडर-ओनली लॉगिंग लाइब्रेरी है, जो MIT लाइसेंस के तहत उपलब्ध है। इसकी मुख्य विशेषता अविश्वसनीय परफॉरमेंस है, जो एसिंक्रोनस राइटिंग, न्यूनतम एलोकेशन और C++11/14/17 की आधुनिक क्षमताओं के उपयोग से प्राप्त होती है। बेंचमार्क में spdlog अक्सर glog या Boost.Log जैसी लाइब्रेरीज़ से 5-10 गुना तेज़ पाई जाती है।

spdlog का उपयोग क्यों करें? किसी भी जटिल C++ एप्लिकेशन में लॉगिंग एक विलासिता नहीं, बल्कि आवश्यकता है। यह मदद करता है:

• प्रोडक्शन एनवायरनमेंट में एरर डीबग करना जहां डीबगर उपलब्ध नहीं है।
• प्रोग्राम के एक्ज़ीक्यूशन फ्लो को ट्रैक करना (ट्रेसिंग)।
• परफॉरमेंस का विश्लेषण करना (कोड सेक्शन के एक्ज़ीक्यूशन टाइम को मापना)।
• सुरक्षा ऑडिट करना (लॉगिन प्रयासों, डेटा परिवर्तनों को रिकॉर्ड करना)।

spdlog एक लचीली प्रणाली प्रदान करता है: आप लॉग को कंसोल, फ़ाइलों (साइज़ या टाइम के अनुसार रोटेशन के साथ), सिस्टम लॉग (syslog), डेटाबेस (ODBC के माध्यम से) या नेटवर्क पर भी भेज सकते हैं। एसिंक्रोनस मोड सपोर्ट किया जाता है, जो लॉग लिखते समय मुख्य थ्रेड को ब्लॉक नहीं होने देता।

spdlog की स्थापना (इंस्टॉलेशन)

Python के विपरीत, C++ में कोई एकल पैकेज मैनेजर नहीं है, लेकिन spdlog को स्थापित करने के कई मानक तरीके हैं।

तरीका 1: हेडर-ओनली (शुरुआत के लिए अनुशंसित)

सबसे आसान तरीका है हेडर फ़ाइलें डाउनलोड करना और उन्हें अपने प्रोजेक्ट में शामिल करना। किसी कंपाइलेशन की आवश्यकता नहीं है।

1. GitHub से नवीनतम रिलीज़ डाउनलोड करें।
2. आर्काइव को अनज़िप करें।
3. include/spdlog फ़ोल्डर को अपने प्रोजेक्ट में कॉपी करें।
4. कोड में #include "spdlog/spdlog.h" का उपयोग करें।

तरीका 2: vcpkg पैकेज मैनेजर के माध्यम से

vcpkg Microsoft का C++ के लिए लोकप्रिय पैकेज मैनेजर है।

# इंस्टॉलेशन
git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh  # या Windows पर bootstrap-vcpkg.bat
./vcpkg install spdlog

# अपनी बिल्ड सिस्टम के साथ इंटीग्रेशन
./vcpkg integrate install

तरीका 3: Conan के माध्यम से

Conan एक और लोकप्रिय पैकेज मैनेजर है।

# conanfile.txt फ़ाइल में
[requires]
spdlog/1.12.0

[generators]
cmake_find_package

# इंस्टॉलेशन
conan install . --build=missing

तरीका 4: CMake FetchContent (आधुनिक तरीका)

यदि आप CMake का उपयोग करते हैं, तो आप लाइब्रेरी को सीधे रिपॉजिटरी से खींच सकते हैं:

include(FetchContent)
FetchContent_Declare(
  spdlog
  GIT_REPOSITORY https://github.com/gabime/spdlog.git
  GIT_TAG v1.12.0
)
FetchContent_MakeAvailable(spdlog)

# अपने टार्गेट में
target_link_libraries(my_app PRIVATE spdlog::spdlog)

कोड उदाहरण के साथ त्वरित शुरुआत

चलिए एक सरल प्रोग्राम लिखते हैं जो विभिन्न स्तरों के लॉग को कंसोल और फ़ाइल में आउटपुट करता है।

#include "spdlog/spdlog.h"
#include "spdlog/sinks/basic_file_sink.h"
#include <memory>

int main() {
    // 1. कंसोल के लिए लॉगर बनाएं (डिफ़ॉल्ट रूप से रंगीन)
    auto console = spdlog::stdout_color_mt("console");

    // 2. फ़ाइल के लिए लॉगर बनाएं
    auto file_logger = spdlog::basic_logger_mt("file_logger", "logs/app.log");

    // 3. लॉगिंग स्तर सेट करें (डिफ़ॉल्ट - trace)
    spdlog::set_level(spdlog::level::trace);

    // 4. विभिन्न स्तरों के संदेश लिखें
    console->trace("यह trace-संदेश है (सबसे विस्तृत स्तर)");
    console->debug("Debug: वेरिएबल x का मान = {}", 42);
    console->info("प्रोग्राम सफलतापूर्वक शुरू हुआ");
    console->warn("चेतावनी: मेमोरी लगभग खत्म हो गई है");
    console->error("त्रुटि: फ़ाइल खोलने में विफल");
    console->critical("गंभीर त्रुटि: एप्लिकेशन बंद हो जाएगा!");

    // 5. फ़ाइल में लिखें
    file_logger