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

Base64 एक ऐसी एन्कोडिंग स्कीम है जो बाइनरी डेटा को 64 ASCII अक्षरों पर आधारित टेक्स्ट फॉर्मेट में बदल देती है। इसका उपयोग उन चैनलों के माध्यम से डेटा भेजने के लिए व्यापक रूप से किया जाता है जो बाइनरी फॉर्मेट को सपोर्ट नहीं करते, जैसे URL, ईमेल (MIME) या JSON में इमेज स्टोर करना। Rust के लिए base64 लाइब्रेरी Base64 फॉर्मेट में डेटा को एन्कोड और डीकोड करने के लिए तेज़ और सुरक्षित फंक्शन प्रदान करती है, साथ ही इस फॉर्मेट के विभिन्न वेरिएंट (जैसे URL-safe Base64) को भी सपोर्ट करती है।

यह क्यों ज़रूरी है? आधुनिक वेब डेवलपमेंट और सिस्टम प्रोग्रामिंग में अक्सर बाइनरी डेटा (इमेज, फ़ाइलें, एन्क्रिप्शन कीज़) को टेक्स्ट प्रोटोकॉल के माध्यम से भेजने की आवश्यकता होती है। Base64 इस समस्या को हल करता है, बाइट्स को एक स्ट्रिंग में बदलकर जिसे सुरक्षित रूप से JSON, XML या HTTP हेडर में डाला जा सकता है। Rust वर्जन लाइब्रेरी उच्च प्रदर्शन और सख्त टाइपिंग के लिए जानी जाती है, जो इसे उन सिस्टमों के लिए आदर्श बनाती है जहाँ विश्वसनीयता और गति महत्वपूर्ण है।

लाइब्रेरी कई मानकों को सपोर्ट करती है: स्टैंडर्ड Base64 (RFC 4648), URL-safe Base64 (+ और / को - और _ से बदलकर), साथ ही पैडिंग के साथ और बिना पैडिंग के वेरिएंट। यह इसे सरल स्ट्रिंग एन्कोडिंग से लेकर स्ट्रीमिंग मोड में बड़ी फ़ाइलों को प्रोसेस करने तक, विभिन्न परिदृश्यों में उपयोग करने की अनुमति देता है।

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

Rust प्रोजेक्ट में base64 लाइब्रेरी इंस्टॉल करने के लिए Cargo पैकेज मैनेजर का उपयोग करें। Cargo.toml फ़ाइल में डिपेंडेंसी जोड़ें:

[dependencies]
base64 = "0.22"

फिर डिपेंडेंसी डाउनलोड और बिल्ड करने के लिए कमांड चलाएँ:

cargo build

यदि आप GitHub रिपॉजिटरी से नवीनतम वर्जन का उपयोग करना चाहते हैं, तो यह निर्दिष्ट करें:

[dependencies]
base64 = { git = "https://github.com/marshallpierce/rust-base64" }

डिपेंडेंसी जोड़ने के बाद, आप use base64::*; का उपयोग करके अपने कोड में लाइब्रेरी को इम्पोर्ट कर सकते हैं।

3. त्वरित शुरुआत

स्ट्रिंग को एन्कोड और डीकोड करने का न्यूनतम कार्यशील उदाहरण:

use base64::{Engine as _, engine::general_purpose};

fn main() {
    let input = b"Hello, Rust!";
    
    // एन्कोडिंग
    let encoded = general_purpose::STANDARD.encode(input);
    println!("Encoded: {}", encoded); // आउटपुट: SGVsbG8sIFJ1c3Qh
    
    // डीकोडिंग
    let decoded = general_purpose::STANDARD.decode(&encoded).unwrap();
    println!("Decoded: {}", String::from_utf8(decoded).unwrap()); // आउटपुट: Hello, Rust!
}

यह उदाहरण बुनियादी कार्यप्रणाली दिखाता है: हम एक बाइट ऐरे को Base64 स्ट्रिंग में एन्कोड करते हैं, और फिर इसे वापस डीकोड करते हैं। Engine ट्रेट के इम्पोर्ट पर ध्यान दें — यह encode और decode मेथड को कॉल करने के लिए आवश्यक है।

4. मुख्य मेथड और फंक्शन

लाइब्रेरी Base64 के साथ काम करने के कई तरीके प्रदान करती है। नीचे कार्यक्षमता के अनुसार समूहित मुख्य मेथड दिए गए हैं।

4.1. Engine::encode

सिग्नेचर: fn encode(&self, input: &[u8]) -> String

विवरण: मनमाने बाइट्स को Base64 स्ट्रिंग में एन्कोड करता है। एन्कोडिंग फॉर्मेट निर्धारित करने के लिए चयनित इंजन का उपयोग करता है।

use base64::{Engine as _, engine::general_purpose};

let data = b"Data to encode";
let encoded = general_purpose::STANDARD.encode(data);
println!("{}", encoded); // RGF0YSB0byBlbmNvZGU=