Deref & Deref Coercion

Deref mapeia ponteiros inteligentes para referências internas. Deref coercion converte &T para &U quando T: Deref<Target=U> em locais de chamada.

Receita

use std::ops::Deref;
 
struct MyString(String);
impl Deref for MyString {
    type Target = str;
    fn deref(&self) -> &str { &self.0 }
}
 
fn print_len(s: &str) { println!("{}", s.len()); }
 
fn main() {
    let s = MyString("hello".into());
    print_len(&s); // coerção &MyString -> &str
}

Quando usar isso: Wrappers Newtype e ponteiros inteligentes agindo como o tipo interno.

Exemplo de Trabalho

fn main() {
    let s = String::from("rust");
    let len = str_len(&s);
    println!("{len}");
}
 
fn str_len(s: &str) -> usize { s.len() }

O que isso demonstra:

• &String é coerido para &str via Deref
• Box<T>, Rc<T> similarmente coerem quando T: Deref
• Automático em argumentos de função

Análise Detalhada

A cadeia de Deref coercion é limitada para evitar recursão infinita. DerefMut para coerção mutável.

Armadilhas

• Deref retornando lifetime incorreto - Erros de compilação. Correção: Corresponder ao lifetime do campo interno.
• Over-Deref em API - Alocações ocultas se Deref clona. Correção: Implementar Deref apenas para referência interna.
• Abuso de polimorfismo Deref - Não é herança. Correção: Preferir traits para compartilhamento de comportamento.
• Coerção ambígua - Múltiplos caminhos Deref são raros.
• * manual para dereferenciar - *box para dereferenciar explicitamente.

Alternativas

FAQs

Relacionados

• Ponteiros Inteligentes Customizados
• Box<T>
• Sobrecarga de Operadores
• Referências & Slices

Versões da Stack: 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+.