`HashMap::drain` în Rust

HashMap: dicționare cheie-valoare Rust 1.6

Golește dicționarul și dă toate perechile ca iterator, prin valoare; dicționarul rămâne gol, dar utilizabil.

Sintaxă

pub fn drain(&mut self) -> Drain<'_, K, V>

Ce face `HashMap::drain`

drain() scoate toate perechile (K, V), mutate, și le dă printr-un iterator. După aceea dicționarul este gol, dar își păstrează memoria și poate fi umplut din nou.

Diferența față de into_iter(): into_iter consumă dicționarul (variabila nu mai poate fi folosită), drain doar îl golește. Ca la orice parcurgere de HashMap, ordinea perechilor este aleatorie.

Ce returnează

Un iterator Drain care produce perechi (K, V).

Exemple

Exemplul 1: Trimiterea facturilor adunate

use std::collections::HashMap;

fn main() {
    let mut de_trimis = HashMap::from([(1, "factura 1"), (2, "factura 2"), (3, "factura 3")]);
    let mut lot: Vec<(i32, &str)> = de_trimis.drain().collect();
    lot.sort();
    for (id, doc) in &lot {
        println!("trimit #{id}: {doc}");
    }
    println!("rămase: {}, memorie păstrată: {}", de_trimis.len(), de_trimis.capacity() >= 3);

    de_trimis.insert(4, "factura 4");
    println!("reumplut: {:?}", de_trimis);
}

Rezultat

trimit #1: factura 1
trimit #2: factura 2
trimit #3: factura 3
rămase: 0, memorie păstrată: true
reumplut: {4: "factura 4"}

Exemplul 2: Contoare pe minut, golite la fiecare raport

use std::collections::HashMap;

fn main() {
    let mut contor: HashMap<&str, u32> = HashMap::new();
    let minute = [vec!["GET", "GET", "POST"], vec!["GET", "DELETE"]];
    for (i, cereri) in minute.iter().enumerate() {
        for &c in cereri {
            *contor.entry(c).or_default() += 1;
        }
        let mut raport: Vec<_> = contor.drain().collect();
        raport.sort();
        println!("minutul {}: {:?}", i + 1, raport);
    }
}