الـ Structs كمعاملات للدوال

جزء من قسم Logic & Flow في رحلة Rust على Coddy — الدرس 24 من 66.

الآن بعد أن عرفت كيفية إنشاء وتعديل الـ structs، دعنا نستكشف كيفية استخدامها مع الدوال. تماماً مثل أي نوع بيانات آخر في Rust، يمكنك تمرير مثيلات الـ struct إلى الدوال وإعادتها من الدوال.

لتمرير هيكل (struct) إلى دالة، ما عليك سوى تضمينه كمعامل في تعريف الدالة:

fn calculate_area(rect: Rectangle) -> i32 {
    rect.width * rect.height
}

تأخذ هذه الدالة هيكل Rectangle كمعامل وترجع i32. داخل الدالة، يمكنك الوصول إلى حقول الهيكل باستخدام تدوين النقطة (dot notation)، تماماً كما تفعل في أي مكان آخر.

يمكنك أيضاً إرجاع الهياكل (structs) من الدوال عن طريق تحديد نوع الهيكل كنوع للإرجاع:

fn create_square(size: i32) -> Rectangle {
    Rectangle {
        width: size,
        height: size,
    }
}

إن استخدام الـ structs مع الدوال يجعل الكود الخاص بك أكثر تنظيمًا ووضوحًا. فبدلاً من تمرير عدة معاملات فردية، يمكنك تجميع البيانات ذات الصلة معًا وتمريرها كوحدة واحدة محددة جيدًا.

التحدي

سهل

ستتلقى أربعة مدخلات: عرض المستطيل (كعدد صحيح)، وارتفاع المستطيل (كعدد صحيح)، وطول ضلع المربع (كعدد صحيح)، ورقم الخيار (1 أو 2). قم بتعريف هيكل Rectangle بحقلين: width: i32 و height: i32. قم بإنشاء دالتين: واحدة تأخذ Rectangle وتحسب مساحته، والأخرى تأخذ طول الضلع وتعيد Rectangle يمثل مربعاً. بناءً على رقم الخيار المدخل، قم بحساب وطباعة المساحة المناسبة.

المتطلبات:

تعريف هيكل Rectangle بحقول: width: i32 و height: i32
إنشاء دالة calculate_area تأخذ Rectangle كمعامل وتعيد i32 (المساحة)
إنشاء دالة create_square تأخذ i32 (طول الضلع) كمعامل وتعيد Rectangle بعرض وارتفاع متساويين
قراءة المدخل الأول وتحويله إلى i32 لعرض المستطيل
قراءة المدخل الثاني وتحويله إلى i32 لارتفاع المستطيل
إنشاء مثيل من Rectangle بهذه الأبعاد
قراءة المدخل الثالث وتحويله إلى i32 لطول ضلع المربع
قراءة المدخل الرابع وتحويله إلى i32 للخيار (1 أو 2)
إذا كان الخيار 1: احسب واطبع مساحة المستطيل
إذا كان الخيار 2: أنشئ مربعاً باستخدام create_square، ثم احسب واطبع مساحته

المدخلات:

السطر الأول: عرض المستطيل كعدد صحيح (مثلاً، 8)
السطر الثاني: ارتفاع المستطيل كعدد صحيح (مثلاً، 5)
السطر الثالث: طول ضلع المربع كعدد صحيح (مثلاً، 6)
السطر الرابع: الخيار كعدد صحيح، إما 1 أو 2 (مثلاً، 1)

المخرجات:

إذا كان الخيار 1: Rectangle area: [area]
إذا كان الخيار 2: Square area: [area]

ورقة مرجعية

يمكن تمرير الهياكل (Structs) إلى الدوال كمعاملات وإرجاعها من الدوال.

لتمرير هيكل (struct) إلى دالة، قم بتضمينه كمعامل:

fn calculate_area(rect: Rectangle) -> i32 {
    rect.width * rect.height
}

لإرجاع هيكل من دالة، حدد نوع الهيكل كنوع للإرجاع:

fn create_square(size: i32) -> Rectangle {
    Rectangle {
        width: size,
        height: size,
    }
}

داخل الدوال، يمكنك الوصول إلى حقول الهيكل باستخدام تدوين النقطة (dot notation). يتيح لك استخدام الهياكل مع الدوال تجميع البيانات ذات الصلة معاً بدلاً من تمرير عدة معاملات فردية.

جرّب بنفسك

use std::io;

// TODO: قم بتعريف هيكل Rectangle هنا


// TODO: قم بتعريف دالة calculate_area هنا


// TODO: قم بتعريف دالة create_square هنا


fn main() {
    // قراءة عرض المستطيل
    let mut width_input = String::new();
    io::stdin().read_line(&mut width_input).expect("Failed to read line");
    let width: i32 = width_input.trim().parse().expect("Invalid input");
    
    // قراءة طول المستطيل
    let mut height_input = String::new();
    io::stdin().read_line(&mut height_input).expect("Failed to read line");
    let height: i32 = height_input.trim().parse().expect("Invalid input");
    
    // قراءة طول ضلع المربع
    let mut side_input = String::new();
    io::stdin().read_line(&mut side_input).expect("Failed to read line");
    let side: i32 = side_input.trim().parse().expect("Invalid input");
    
    // قراءة الخيار
    let mut choice_input = String::new();
    io::stdin().read_line(&mut choice_input).expect("Failed to read line");
    let choice: i32 = choice_input.trim().parse().expect("Invalid input");
    
    // TODO: اكتب الكود الخاص بك أدناه
    // قم بإنشاء مثيل لـ Rectangle، وتحقق من الخيار، واحسب المساحة المناسبة
    
    
    // إخراج النتيجة بناءً على الخيار
    // استخدم: println!("Rectangle area: {}", area); أو println!("Square area: {}", area);
}