Rust Programlama Dili

Hataları Standart Hata Çıktısına Yönlendirme

Şu anda println! makrosunu kullanarak tüm çıktılarımızı terminale yazıyoruz. Çoğu terminalde iki tür çıktı akışı bulunur: Genel bilgiler için standart çıktı (standard output, stdout) ve hata mesajları için standart hata (standard error, stderr). Bu ayrım sayesinde kullanıcılar, bir programın başarılı çıktısını bir dosyaya yönlendirirken hata mesajlarının yine de ekrana yazdırılmasını sağlayabilir.

println! makrosu yalnızca standart çıktıya yazdırabilir; dolayısıyla standart hataya yazdırmak için başka bir araç kullanmamız gerekir.

Hataların Nereye Yazıldığını Kontrol Etme

İlk olarak, standart hataya yazdırmak istediğimiz hata mesajları da dahil olmak üzere minigrep tarafından üretilen tüm çıktının şu anda standart çıktıya nasıl yazıldığını gözlemleyelim. Bunu görmek için bilerek bir hataya yol açarken standart çıktı akışını bir dosyaya yönlendireceğiz. Standart hata akışını yönlendirmeyeceğimiz için standart hataya gönderilen her türlü içerik ekranda görünmeye devam edecektir.

Komut satırı programlarının hata mesajlarını standart hata akışına göndermesi beklenir; böylece standart çıktı akışını bir dosyaya yönlendirsek bile hata mesajlarını ekranda görmeye devam edebiliriz. Programımız şu anda bu kurala uygun davranmıyor: Birazdan hata mesajı çıktısını ekrana basmak yerine dosyaya kaydettiğini göreceğiz!

Bu davranışı göstermek için programı > operatörü ve standart çıktı akışını yönlendirmek istediğimiz cikti.txt dosya yoluyla çalıştıracağız. Hataya yol açması için hiçbir argüman iletmeyeceğiz:

$ cargo run > cikti.txt

> sözdizimi, kabuğa standart çıktının içeriğini ekran yerine cikti.txt dosyasına yazmasını söyler. Ekranda görmeyi beklediğimiz hata mesajıyla karşılaşmadık; demek ki mesaj dosyaya yazılmış olmalı. cikti.txt dosyasının içeriği şöyledir:

Argümanları ayrıştırırken problem oluştu: yeterli argüman yok

Gerçekten de hata mesajımız standart çıktıya yazdırılıyor. Bu tür hata mesajlarının standart hataya yazdırılması çok daha kullanışlıdır; böylece dosyaya yalnızca başarılı bir çalıştırmadan elde edilen veriler kaydedilir. Şimdi bunu değiştireceğiz.

Hataları Standart Hata Çıktısına Yazdırma

Hata mesajlarının yazdırılma biçimini değiştirmek için Liste 12-24’teki kodu kullanacağız. Bu bölümün başlarında yaptığımız yeniden düzenleme sayesinde, hata mesajlarını yazdıran tüm kodlar tek bir fonksiyonda, yani main içinde toplanmış durumda. Standart kütüphane, standart hata akışına yazdıran eprintln! makrosunu sunar; dolayısıyla hata yazdırmak için println! çağırdığımız iki yeri eprintln! kullanacak şekilde değiştirelim.

use std::env;
use std::error::Error;
use std::fs;
use std::process;

use minigrep::{ara, buyuk_kucuk_harf_duyarsiz_ara};

fn main() {
    let argumanlar: Vec<String> = env::args().collect();

    let yapilandirma =
        Yapilandirma::olustur(&argumanlar).unwrap_or_else(|hata| {
            eprintln!("Argümanları ayrıştırırken problem oluştu: {hata}");
            process::exit(1);
        });

    if let Err(e) = calistir(yapilandirma) {
        eprintln!("Uygulama hatası: {e}");
        process::exit(1);
    }
}

pub struct Yapilandirma {
    pub sorgu: String,
    pub dosya_yolu: String,
    pub buyuk_kucuk_harf_yoksay: bool,
}

impl Yapilandirma {
    fn olustur(argumanlar: &[String]) -> Result<Yapilandirma, &'static str> {
        if argumanlar.len() < 3 {
            return Err("yeterli argüman yok");
        }

        let sorgu = argumanlar[1].clone();
        let dosya_yolu = argumanlar[2].clone();

        let buyuk_kucuk_harf_yoksay = env::var("IGNORE_CASE").is_ok();

        Ok(Yapilandirma {
            sorgu,
            dosya_yolu,
            buyuk_kucuk_harf_yoksay,
        })
    }
}

fn calistir(yapilandirma: Yapilandirma) -> Result<(), Box<dyn Error>> {
    let icerik = fs::read_to_string(yapilandirma.dosya_yolu)?;

    let sonuclar = if yapilandirma.buyuk_kucuk_harf_yoksay {
        buyuk_kucuk_harf_duyarsiz_ara(&yapilandirma.sorgu, &icerik)
    } else {
        ara(&yapilandirma.sorgu, &icerik)
    };

    for satir in sonuclar {
        println!("{satir}");
    }

    Ok(())
}

Şimdi programı hiçbir argüman vermeden ve standart çıktıyı > ile yönlendirerek aynı şekilde tekrar çalıştıralım:

$ cargo run > cikti.txt
Argümanları ayrıştırırken problem oluştu: yeterli argüman yok

Artık hatayı ekranda görüyoruz ve cikti.txt dosyası hiçbir şey içermiyor; komut satırı programlarından beklenen davranış da tam olarak budur.

Şimdi programı hataya yol açmayan argümanlarla tekrar çalıştıralım, ancak standart çıktıyı yine aşağıdaki gibi bir dosyaya yönlendirelim:

$ cargo run -- ne siir.txt > cikti.txt

Terminalde herhangi bir çıktı görmeyeceğiz ve cikti.txt dosyası arama sonuçlarımızı barındıracak:

Dosya adı: cikti.txt

Gelme, artık neye yarar?

Bu sonuç, artık başarılı çıktılar için standart çıktıyı, hata mesajları içinse standart hatayı olması gerektiği gibi kullandığımızı gösterir.

Özet

Bu bölümde, şimdiye kadar öğrendiğiniz pek çok temel kavramı yeniden hatırladık ve Rust’ta yaygın G/Ç işlemlerinin nasıl gerçekleştirileceğini ele aldık. Komut satırı argümanlarını, dosyaları, çevre değişkenlerini ve hata yazdırmaya yarayan eprintln! makrosunu kullanarak artık komut satırı uygulamaları geliştirmeye hazırsınız. Bunları önceki bölümlerdeki kavramlarla bir araya getirdiğinizde kodunuz iyi organize edilmiş ve iyi test edilmiş olacak; verileri uygun veri yapılarında verimli biçimde saklayıp hataları düzgünce yönetecektir.

Bir sonraki bölümde fonksiyonel dillerden esinlenen bazı Rust özelliklerini inceleyeceğiz: kapanışlar ve iteratörler.