`io::BufWriter` în Rust

Adaugă un buffer peste orice scriitor: strânge scrierile mici și le trimite în bucăți mari, mult mai rapid.

Sintaxă

use std::io::BufWriter;

fn new(inner: W) -> BufWriter<W>   // W: Write

Ce face `io::BufWriter`

Fiecare write direct pe un File este un apel către sistemul de operare. BufWriter::new(f) strânge datele în memorie (8 KB implicit) și le scrie în fișier doar când bufferul se umple, la flush() sau când BufWriter-ul dispare.

Important: la distrugere, BufWriter încearcă să scrie ce a rămas, dar ignoră erorile. Ca să afli dacă scrierea a reușit, apelează explicit flush()? la final. into_inner() face flush și îți dă înapoi scriitorul din interior.

Parametri

Parametru	Descriere
`inner`	Scriitorul împachetat: `File`, `Stdout`, `TcpStream` etc.

Ce returnează

Un BufWriter<W>.

Exemple

Exemplul 1: Scrierea a multe linii într-un fișier

use std::fs::{self, File};
use std::io::{self, BufWriter, Write};

fn main() -> io::Result<()> {
    let mut w = BufWriter::new(File::create("patrate.txt")?);
    for n in 1..=1000 {
        writeln!(w, "{n} {}", n * n)?;
    }
    w.flush()?;

    let text = fs::read_to_string("patrate.txt")?;
    println!("{} linii, ultima: {}", text.lines().count(), text.lines().last().unwrap_or(""));
    Ok(())
}

Rezultat

1000 linii, ultima: 1000 1000000

Exemplul 2: Datele stau în buffer până la flush

Înainte de flush, fișierul este încă gol pe disc.

use std::fs::{self, File};
use std::io::{self, BufWriter, Write};

fn main() -> io::Result<()> {
    let mut w = BufWriter::new(File::create("mesaj.txt")?);
    write!(w, "Salut din Iași")?;
    println!("înainte de flush: {} octeți în fișier", fs::metadata("mesaj.txt")?.len());

    w.flush()?;
    println!("după flush: {} octeți în fișier", fs::metadata("mesaj.txt")?.len());
    Ok(())
}