Formatação e Impressão

Rust formata texto com macros (println!, format!, write!) suportadas pelos traits std::fmt Display e Debug. Especificadores de formato controlam largura, precisão e alinhamento.

Receita

#[derive(Debug)]
struct User { id: u64, name: String }
 
fn main() {
    let u = User { id: 1, name: "Ada".into() };
    println!("{}", u.name);
    println!("{:?}", u);
    println!("{:#?}", u);
    eprintln!("log: id={}", u.id);
}

Quando usar isso: Saída de CLI, logs, falhas de teste e implementação de formas de string visíveis ao usuário para seus tipos.

Exemplo de Trabalho

use std::fmt;
 
struct Point { x: i32, y: i32 }
 
impl fmt::Display for Point {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "({}, {})", self.x, self.y)
    }
}
 
fn main() {
    let p = Point { x: 3, y: 4 };
    println!("point={p}");
    println!("{:>10}", p);
    let s = format!("moved {p}");
    assert_eq!(s, "moved (3, 4)");
}

O que isto demonstra:

• Implementação manual de Display para formatação personalizada
• Largura de alinhamento {:>10} alinha à direita em 10 colunas
• format! aloca uma String
• eprintln! escreve para stderr

Mergulho Profundo

Macros Comuns

Especificadores de Formato

println!("{:.2}", 3.14159);      // 3.14
println!("{:08x}", 255);         // 000000ff
println!("{name}", name = "Rust"); // argumentos nomeados

Debug vs Display

• Debug: orientado a desenvolvedor, frequentemente derivado
• Display: voltado ao usuário, implementação manual necessária para tipos personalizados
• #? imprime Debug de forma formatada com indentação

Armadilhas

• println!(my_struct) sem Display - Erro de compilação. Correção: Derive Debug e use {:?}, ou implemente Display.
• Formatação de não-UTF-8 para usuários - Debug pode escapar strings de forma estranha. Correção: Implemente Display para texto legível.
• Usar format! em loops críticos - Aloca a cada chamada. Correção: Use write! para um buffer ou reutilize String com clear().
• Escapando chaves incorretamente - {{ e }} produzem chaves literais. Correção: Dobre as chaves em strings de formato.
• Panicking em Display::fmt - Deve retornar fmt::Error, não entrar em pânico. Correção: Propague fmt::Result.

Alternativas

FAQs

Relacionados

• Noções Básicas de Strings - String vs &str
• Formatação - padrões de formato avançados
• Derivando Traits - #[derive(Debug)]
• Traits Padrão Comuns - Display, Debug

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+.