معالجة الأخطاء و؟ المشغل

تشجعك فلسفة Rust على التعرف على احتمالية حدوث أخطاء بشكل صريح وبناء التعليمات البرمجية الخاصة بك للتعامل معها قبل تجميع البرنامج.

تنقسم الأخطاء في Rust إلى فئتين رئيسيتين: الأخطاء غير القابلة للاسترداد (التي تتسبب في الإنهاء الفوري عبر الماكرو panic!) و الأخطاء القابلة للاسترداد (التي تتم إدارتها باستخدام النوع Result<T, E>).

النتيجة<T, E> مطابقة النوع والنمط

تُرجع معظم الأخطاء القابلة للاسترداد النوع Result<T, E>، وهو عبارة عن تعداد تم تعريفه على النحو التالي:

enum Result<T, E> {
    Ok(T),
    Err(E),
}

يمكننا استخدام مطابقة الأنماط لفحص النتيجة:

use std::fs::File;

fn main() {
    let greeting_file_result = File::open("hello.txt");

    let greeting_file = match greeting_file_result {
        Ok(file) => file,
        Err(error) => panic!("Problem opening the file: {:?}", error),
    };
}

انتشار الخطأ باستخدام عامل التشغيل ?

عند تنفيذ دالة، بدلًا من معالجة الخطأ بداخلها مباشرةً، غالبًا ما نرغب في إعادة الخطأ إلى المتصل حتى يتمكن من تحديد ما يجب فعله. تسمى هذه العملية انتشار الخطأ.

يوفر Rust عامل التشغيل ? كاختصار نحوي لنشر الأخطاء. إذا كانت قيمة Result هي Ok، فسيتم إرجاع القيمة الداخلية لـ Ok بواسطة التعبير؛ إذا كان Err، فسيتم إرجاع الخطأ Err من الوظيفة الحالية بأكملها كما لو أننا استخدمنا return Err(...).

use std::fs::File;
use std::io::{self, Read};

fn read_username_from_file() -> Result<String, io::Error> {
    let mut username_file = File::open("username.txt")?;
    let mut username = String::new();
    username_file.read_to_string(&mut username)?;
    Ok(username)
}

[!هام] لا يمكن استخدام عامل التشغيل ? إلا في الوظائف التي تُرجع نوعًا متوافقًا مع القيمة المطبقة عليها (عادةً Result، أو Option، أو الأنواع التي تنفذ FromResidual).

الأخطاء المخصصة

يمكننا تحديد أنواع الأخطاء المخصصة الخاصة بنا من خلال تطبيق السمة std::fmt::Display (واختياريًا std::error::Error) لتوفير تمثيل للخطأ يمكن قراءته بواسطة الإنسان:

use std::fmt;

#[derive(Debug)]
struct MyError {
    details: String,
}

impl fmt::Display for MyError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "Error: {}", self.details)
    }
}

impl std::error::Error for MyError {}

جربه بنفسك

التمرين 1: قراءة ملف بالملحق ? مشغل

التمرين 2: تحليل الرقم ومضاعفته

التمرين 3: تحديد خطأ مخصص