Fn, FnMut & FnOnce

Closures implementam Fn (empréstimo compartilhado), FnMut (empréstimo mutável) ou FnOnce (consome capturas) com base no uso.

Receita

fn call_twice(f: impl Fn() -> i32) -> i32 {
    f() + f()
}
 
fn main() {
    let n = 10;
    println!("{}", call_twice(|| n));
}

Quando usar: Limitar parâmetros de closure em APIs genéricas (thread::spawn precisa de FnOnce).

Exemplo de Trabalho

fn with_mut(f: impl FnMut(&mut Vec<i32>)) {
    let mut v = vec![1];
    f(&mut v);
}
 
fn main() {
    with_mut(|v| v.push(2));
}

O que isto demonstra:

• FnMut para modificar estado capturado ou argumentos de referência mutável.
• FnOnce necessário se a closure consumir uma String capturada.
• O compilador escolhe a implementação mínima do trait.

Mergulho Profundo

Fn é um subtrait de FnMut, que é um subtrait de FnOnce. Prefira impl Fn quando possível para flexibilidade.

Armadilhas

• spawn requer FnOnce + Send + 'static: Capturas devem ser de propriedade. Correção: closure move.
• Armazenar objeto de trait FnMut: Box<dyn FnMut()>. Correção: Box ou genérico.
• Chamar FnOnce duas vezes: Erro de compilação. Correção: Chamar uma vez ou clonar os dados antes.
• Capturas conflitantes: Mover e emprestar a mesma variável. Correção: Reestruturar capturas.
• Referências de método em closure: A implementação automática do trait pode ser FnMut.

Alternativas

FAQs

Relacionados

• Básicos de Closures
• Closures move
• Retornando Closures
• Funções de Ordem Superior

Versões da Pilha: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, e Polars 0.46+.