`Iterator::filter` în Rust

Adaptoare de iteratori (leneșe) Rust 1.0

Păstrează doar elementele pentru care condiția dată returnează true; restul sunt sărite.

Sintaxă

fn filter<P>(self, predicate: P) -> Filter<Self, P>
where P: FnMut(&Self::Item) -> bool

Ce face `Iterator::filter`

filter(|x| condiție) produce doar elementele care îndeplinesc condiția, în ordinea inițială. Elementele nu sunt modificate. Ca toate adaptoarele, este leneș: nu face nimic până când iteratorul nu este consumat (de for, collect, sum, count etc.).

Closure-ul primește o referință la element (&Self::Item), ca să poată doar să se uite la el. Pentru v.iter(), elementul este deja &T, deci closure-ul primește &&T. De aici modelele des întâlnite: |&&x| x > 5 sau |x| **x > 5. Cu .copied() înainte, lucrezi cu &T simplu.

Parametri

Parametru	Descriere
`predicate`	Closure-ul care primește `&element` și returnează `true` pentru elementele păstrate.

Ce returnează

Un iterator Filter cu elementele care trec condiția.

Exemple

Exemplul 1: Note de trecere și orașe lungi

fn main() {
    let note = vec![4, 9, 3, 10, 7, 5];
    let trecere: Vec<&i32> = note.iter().filter(|&&n| n >= 5).collect();
    println!("{:?}", trecere);

    let peste_8: Vec<i32> = note.iter().copied().filter(|n| *n > 8).collect();
    println!("{:?}", peste_8);

    let orase = ["Iași", "Constanța", "Arad", "Timișoara"];
    let lungi: Vec<&str> = orase.into_iter().filter(|o| o.chars().count() > 5).collect();
    println!("{:?}", lungi);
}

Rezultat

[9, 10, 7, 5]
[9, 10]
["Constanța", "Timișoara"]

Exemplul 2: Mai multe filtre înlănțuite

Fiecare filter lucrează doar pe ce a trecut de cel dinainte; totul se face dintr-o singură parcurgere.

struct Comanda {
    oras: &'static str,
    suma: u32,
    platita: bool,
}

fn main() {
    let comenzi = vec![
        Comanda { oras: "Iași", suma: 120, platita: true },
        Comanda { oras: "Cluj", suma: 300, platita: false },
        Comanda { oras: "Iași", suma: 45, platita: true },
        Comanda { oras: "Iași", suma: 210, platita: true },
    ];
    let mari_platite_iasi: Vec<u32> = comenzi
        .iter()
        .filter(|c| c.oras == "Iași")
        .filter(|c| c.platita)
        .filter(|c| c.suma >= 100)
        .map(|c| c.suma)
        .collect();
    println!("{:?}", mari_platite_iasi);
}