تخطَّ إلى المحتوى

🦀 شرح Rust

المجموعات (Collections)

الدرس 15 من 28· ⏱ 3 دقائق قراءة· 🗓 آخر تحديث: ١٨ أكتوبر ٢٠٢٦

لماذا "مجموعات"؟

المصفوفة [T; N] حجمها ثابت ومعروف وقت الترجمة. المجموعات في المكتبة القياسية تخزّن بياناتها على الكومة، فيمكن أن تكبر وتصغر أثناء التشغيل. الثلاث الأكثر استخدامًا: Vec وString وHashMap.

Vec: قائمة ديناميكية

let mut v: Vec<i32> = Vec::new();
v.push(1);
v.push(2);
v.push(3);
let last = v.pop();             // Some(3): يزيل الأخير ويُرجعه
println!("{:?} {:?}", v, last); // [1, 2] Some(3)

let v2 = vec![10, 20, 30];      // ماكرو للإنشاء بقيم
let total: i32 = v2.iter().sum();
println!("{total} {}", v2.len());

الوصول: [] أم get؟

let v = vec![10, 20, 30];
println!("{}", v[1]);            // 20
println!("{:?}", v.get(10));     // None: لا panic
// println!("{}", v[10]);        // panic: index out of bounds

v[i] حين تكون متأكدًا أن الفهرس صالح (وإلا فهذا bug)، وv.get(i) حين قد لا يكون: فهرس من المستخدم، أو من حساب قد يخرج عن الحدود.

المرور والتعديل

let mut scores = vec![70, 85, 92];
for s in &mut scores {
    *s += 5;                      // مكافأة للجميع
}
scores.retain(|&s| s >= 80);      // أبقِ الناجحين فقط
scores.sort();
println!("{:?}", scores);         // [90, 97]
println!("{}", scores.contains(&97));

حجز مسبق

Vec::with_capacity(n) تحجز مكانًا لـ n عنصر مرة واحدة. إذا عرفت الحجم التقريبي مسبقًا، تتجنّب إعادة الحجز والنسخ مع كل نموّ.

String: نص يمكن تعديله

let mut s = String::from("مرحبًا");
s.push_str(" بالعالم");
s.push('!');
let greeting = format!("{s} — أهلًا");   // بناء نص من أجزاء
println!("{greeting}");
println!("{} بايت، {} حرف", s.len(), s.chars().count());

String في الحقيقة Vec<u8> يضمن أن المحتوى UTF-8 صالح. لذلك len() بالبايت، ولا يمكن فهرسته بـ s[0]. للحروف استخدم chars()، وللقصّ الآمن انظر درس الشرائح.

ولدمج نصوص: format! هو الأوضح غالبًا. وs1 + &s2 يعمل، لكنه ينقل s1 (يستهلكه) ويستعير s2، وهذا يربك المبتدئين.

HashMap: مفتاح وقيمة

use std::collections::HashMap;

let mut scores = HashMap::new();
scores.insert("براء", 90);
scores.insert("سارة", 85);

if let Some(v) = scores.get("براء") {
    println!("{v}");             // 90
}
println!("{}", scores.contains_key("علي"));   // false

for (name, score) in &scores {   // الترتيب غير مضمون
    println!("{name}: {score}");
}

HashMap ليست في المجال الافتراضي كـ Vec، فتحتاج use std::collections::HashMap.

واجهة entry: الإدراج أو التحديث

أشهر استخدام: العدّ. بدل "إذا وُجد زِده، وإلا أضفه بصفر":

use std::collections::HashMap;

let text = "rust is fast and rust is safe";
let mut counts: HashMap<&str, u32> = HashMap::new();
for word in text.split_whitespace() {
    *counts.entry(word).or_insert(0) += 1;
}
println!("{} {}", counts["rust"], counts["is"]);   // 2 2

entry(key) تعطيك "مكان" المفتاح، وor_insert(0) تضع صفرًا إن لم يوجد وتُرجع مرجعًا قابلًا للتعديل إلى القيمة.

الملكية مع HashMap

إدراج String كمفتاح أو قيمة ينقل ملكيته إلى الخريطة:

use std::collections::HashMap;

let key = String::from("لون");
let mut m = HashMap::new();
m.insert(key, "أزرق");
// println!("{key}");   // ❌ key نُقلت إلى الخريطة
println!("{:?}", m.get("لون"));

أيّها أختار؟

تحتاجاستخدم
قائمة مرتّبة، وصول بالفهرسVec
بحث سريع بمفتاحHashMap
مفاتيح مرتّبة عند المرورBTreeMap
قيم فريدة بلا تكرارHashSet
إضافة وحذف من الطرفينVecDeque

أخطاء شائعة

  • v[i] بفهرس قد يكون خارج الحدود: panic؛ استخدم get.
  • تعديل Vec أثناء المرور عليه: المستعير يمنعه؛ اجمع التغييرات أولًا أو استخدم retain.
  • s[0] على String: غير مسموح؛ استخدم s.chars().next().
  • الاعتماد على ترتيب HashMap: عشوائي؛ استخدم BTreeMap أو رتّب المفاتيح.
  • map[key] لمفتاح غير موجود: panic؛ استخدم get.

🎯 التالي: الأنواع العامّة (Generics).

شرح المجموعات (Collections) — Rust بالعربي
المجموعات (Collections) — Rust بالعربي · The Code Fix

📚 لمزيد من التعمّق في Rust، راجِع كتاب Rust الرسمي.

هل كان هذا الدرس مفيدًا؟