خرابی سے نمٹنے اور؟ آپریٹر

زنگ کا فلسفہ آپ کو غلطیوں کے امکان کو واضح طور پر پہچاننے اور پروگرام کے مرتب ہونے سے پہلے ان کو سنبھالنے کے لیے اپنے کوڈ کی تشکیل کرنے کی ترغیب دیتا ہے۔

زنگ میں ہونے والی خرابیوں کو دو اہم زمروں میں تقسیم کیا گیا ہے: ناقابل بازیافت خرابیاں (جو 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),
    };
}

? آپریٹر کے ساتھ پروپیگیشن میں خرابی۔

کسی فنکشن کو لاگو کرتے وقت، غلطی کو براہ راست اس کے اندر ہینڈل کرنے کے بجائے، ہم اکثر غلطی کو کال کرنے والے کو واپس کرنا چاہتے ہیں تاکہ وہ فیصلہ کر سکیں کہ کیا کرنا ہے۔ اس عمل کو غلطی پھیلانا کہا جاتا ہے۔

رسٹ ? آپریٹر کو غلطیوں کو پھیلانے کے لیے ایک نحوی شارٹ کٹ کے طور پر فراہم کرتا ہے۔ اگر 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: اپنی مرضی کے مطابق غلطی کی وضاحت کرنا