التعدادات مع البيانات

جزء من قسم Object Oriented Programming في رحلة Rust على Coddy — الدرس 14 من 61.

تسمح لك التعدادات (enums) الأساسية في Rust بتعريف نوع بمجموعة ثابتة من المتغيرات (variants) - مثل Direction::North أو Status::Active. لكن التعدادات في Rust أقوى بكثير من ذلك. يمكن لكل متغير أن يحمل بياناته الخاصة، مما يجعل التعدادات مرنة للغاية لنمذجة سيناريوهات العالم الحقيقي.

فكر في نظام مراسلة حيث تحمل أنواع الرسائل المختلفة معلومات مختلفة. تحتوي الرسالة النصية على محتوى، وأمر النقل يحتوي على إحداثيات، وإشارة الخروج لا تحتوي على شيء على الإطلاق. في لغة Rust، يمكنك تمثيل كل هذه الحالات باستخدام enum واحد:

enum Message {
    Quit,
    Move { x: i32, y: i32 },
    Write(String),
    ChangeColor(u8, u8, u8),
}

كل خيار له شكل مختلف. Quit لا يحمل أي بيانات - إنه مجرد إشارة.

يستخدم Move بناء جملة يشبه الـ struct مع حقول مسماة. يحتوي Write على String واحدة باستخدام بناء جملة الـ tuple. يحتوي ChangeColor على ثلاث قيم تمثل مكونات RGB.

إنشاء مثيلات من هذه الأنواع يبدو كالتالي:

let m1 = Message::Quit;
let m2 = Message::Move { x: 10, y: 20 };
let m3 = Message::Write(String::from("Hello"));
let m4 = Message::ChangeColor(255, 128, 0);

جمال هذا النهج هو أن m1 و m2 و m3 و m4 جميعها من نفس النوع: Message. يمكنك تخزينها في نفس المجموعة، أو تمريرها إلى نفس الدالة، أو إرجاع أي متغير من دالة واحدة. يوحد الـ enum أشكال البيانات المختلفة تحت نوع واحد مع الحفاظ على المعلومات المحددة التي يحتاجها كل متغير.

التحدي

سهل

لنقم ببناء نظام إشعارات يستخدم التعدادات (enums) مع البيانات لتمثيل أنواع مختلفة من التنبيهات. يحمل كل نوع إشعار معلومات مختلفة - بعضها يحتوي على رسائل، وبعضها يحتوي على قيم عددية، وبعضها عبارة عن إشارات بسيطة.

ستقوم بإنشاء ملفين لتنظيم الكود الخاص بك:

notification.rs: قم بتعريف Notification enum عام بثلاثة متغيرات (variants):
- Alert — يحمل رسالة String واحدة (صيغة tuple)
- Reminder — يحمل حقولاً مسماة: title (String) و minutes (u32)
- Dismiss — لا يحمل أي بيانات، مجرد إشارة
main.rs: قم باستيراد وحدة الإشعارات الخاصة بك وأنشئ مثيلاً واحداً (instance) لكل متغير. ثم اطبع معلومات حول كل إشعار لتوضيح أن جميع المتغيرات الثلاثة هي من نفس النوع ولكنها تحمل بيانات مختلفة.

عند الطباعة، استخدم تنسيق التصحيح ({:?}) لعرض كل إشعار. ستحتاج إلى اشتقاق سمة Debug في التعداد الخاص بك حتى يمكن طباعته بهذه الطريقة.

يجب أن يظهر مخرجك جميع الإشعارات الثلاثة، كل منها في سطر خاص به:

Alert("{message}")
Reminder { title: "{title}", minutes: {minutes} }
Dismiss

على سبيل المثال، مع رسالة تنبيه "Server down"، وتذكير بالعنوان "Meeting" و 30 دقيقة، سيكون المخرج:

Alert("Server down")
Reminder { title: "Meeting", minutes: 30 }
Dismiss

ستتلقى ثلاثة مدخلات: رسالة التنبيه، وعنوان التذكير، ودقائق التذكير.

جرّب بنفسك

mod notification;

use notification::Notification;

fn main() {
    // قراءة المدخلات
    let mut alert_message = String::new();
    std::io::stdin().read_line(&mut alert_message).expect("Failed to read line");
    let alert_message = alert_message.trim().to_string();

    let mut reminder_title = String::new();
    std::io::stdin().read_line(&mut reminder_title).expect("Failed to read line");
    let reminder_title = reminder_title.trim().to_string();

    let mut minutes_input = String::new();
    std::io::stdin().read_line(&mut minutes_input).expect("Failed to read line");
    let reminder_minutes: u32 = minutes_input.trim().parse().expect("Failed to parse minutes");

    // TODO: إنشاء إشعار Alert باستخدام alert_message

    // TODO: إنشاء إشعار Reminder باستخدام reminder_title و reminder_minutes

    // TODO: إنشاء إشعار Dismiss

    // TODO: طباعة كل إشعار باستخدام تنسيق التصحيح {:?}
    // يجب طباعة كل إشعار في سطر منفصل
}