Bytes لـ Rust: دليل شامل مع أمثلة

ما هي مكتبة Bytes لـ Rust وما أهميتها؟

مكتبة Bytes هي واحدة من أشهر وأهم المكتبات في بيئة Rust، مصممة للعمل بكفاءة مع المخازن المؤقتة للبايتات. توفر المكتبة النوع Bytes وهو قطعة ذاكرة غير قابلة للتغيير وقابلة للمشاركة (عبر حساب المراجع)، مما يسمح بتجنب النسخ المكلف للبيانات عند نقلها بين أجزاء مختلفة من البرنامج أو بين الخيوط.

المشكلة الأساسية التي تحلها Bytes هي إدارة الذاكرة بشكل آمن وفعال عند العمل مع بروتوكولات الشبكات، والمحللات (Parsers)، وقواعد البيانات، وأي تطبيق يتطلب نسخًا ونقلًا متكررًا لكميات كبيرة من البيانات الثنائية. في المكتبة القياسية لـ Rust، يُستخدم Vec<u8> لهذه الأغراض، ولكن عند استنساخ Vec يتم نسخ جميع البيانات بالكامل. أما Bytes فتستخدم آلية حساب المراجع (Atomic Arc)، لذا فإن استنساخ Bytes هو مجرد زيادة في عداد المراجع، دون نسخ البايتات نفسها.

توفر المكتبة أيضًا النوع BytesMut وهو النسخة القابلة للتعديل، والتي تسمح بتعديل البيانات بأمان طالما يوجد مرجع واحد فقط عليها. وهذا يجعل العمل مع المخازن المؤقتة مرنًا وعالي الأداء.

أين تُستخدم Bytes:

• أطر عمل الشبكات (Tokio, Hyper, Tonic)
• محللات البروتوكولات (HTTP, gRPC, WebSocket)
• قواعد البيانات (SQLx, MongoDB driver)
• معالجة البيانات المتدفقة
• أي تطبيق يهتم بأداء إدارة الذاكرة

التثبيت

لتثبيت مكتبة Bytes في مشروع Rust، أضفها إلى ملف Cargo.toml:

[dependencies]
bytes = "1.7"

أو نفذ الأمر التالي:

cargo add bytes

بعد ذلك، يمكنك استيراد المكتبة في الكود:

use bytes::{Bytes, BytesMut, Buf, BufMut};

بداية سريعة مع مثال كود

لننشئ مثالًا بسيطًا يوضح العمل الأساسي مع Bytes:

use bytes::Bytes;

fn main() {
    // إنشاء Bytes من مصفوفة ثابتة
    let data = Bytes::from_static(b"Hello, Rust Bytes!");
    
    // الاستنساخ سريع، البيانات لا تُنسخ
    let clone = data.clone();
    
    // الحصول على شريحة من البيانات
    let slice = &data[7..11];
    
    println!("الأصلي: {:?}", data);
    println!("النسخة: {:?}", clone);
    println!("الشريحة: {:?}", slice);
    println!("الطول: {}", data.len());
    println!("فارغ: {}", data.is_empty());
}

هذا الكود ينشئ مخزنًا مؤقتًا للبايتات، ويستنسخه (بدون نسخ البيانات)، وينشئ شريحة، ويطبع المعلومات. ستلاحظ أن الاستنساخ مجاني تقريبًا من حيث الأداء.

الدوال والطرق الأساسية

1. Bytes::from_static

الوظيفة: تنشئ Bytes من شريحة بايتات ثابتة &'static [u8]. لا يتم نسخ البيانات، بل يتم الإشارة مباشرة إلى ذاكرة البرنامج الثابتة. هذه هي الطريقة الأكثر كفاءة لإنشاء Bytes من بيانات ثابتة.

المعاملات:

• src: &'static [u8] — شريحة بايتات ثابتة

مثال:

use bytes::Bytes;

let static_bytes = Bytes::from_static(b"بيانات ثابتة");
println!("البايتات الثابتة: {:?}", static_bytes);

2. Bytes::copy_from_slice

الوظيفة: تنشئ Bytes جديدة عن طريق نسخ البيانات من شريحة عشوائية &[u8]. على عكس from_static، يتم نسخ البيانات إلى تخصيص ذاكرة جديد. مفيدة عندما لا تكون البيانات الأصلية ثابتة.

المعاملات:

• src: &[u8] — شريحة البايتات الأصلية للنسخ

مثال:

use bytes::Bytes;

let vec_data =