Boas Práticas de Strings

Como Usar Esta Lista

• Revise APIs que aceitam String em todos os lugares.
• Audite suposições de UTF-8 antes de trabalhar com Windows/caminhos.

A - Tipos de API

• Aceite &str (ou impl AsRef<str>) para entradas somente leitura. Flexibilidade para o chamador.
• Retorne String quando o chamador for o proprietário do resultado. Empreste apenas quando estiver vinculado ao tempo de vida da entrada.
• Use Cow<str> quando a mutação for rara. Evite alocações forçadas.
• Use Path/PathBuf para caminhos do sistema de arquivos. Não caminhos String.
• Use OsString ao preservar bytes do SO não-UTF-8. Variáveis de ambiente do Windows.

B - Correção UTF-8

• Nunca indexe str por byte sem is_char_boundary. Previne pânicos.
• Use chars() para escalares Unicode; grafemas para UI. unicode-segmentation.
• Valide bytes externos com from_utf8. Não use unwrap em produção.
• Não assuma que len() é a contagem de caracteres. Documente o comprimento em bytes.
• Normalize ao comparar texto do usuário (NFC). unicode-normalization se necessário.

C - Desempenho

• Pré-aloque com with_capacity quando o tamanho for conhecido. Loops de junção/construção.
• Prefira push_str em vez de + em loops. + move o operando esquerdo.
• Reutilize buffers String com clear. Caminhos de formatação "quentes".
• Compile regex uma vez (LazyLock). Não por linha.
• Evite to_string/clone em loops apertados. Perfis com dhat.

D - FFI e Segurança

• CString rejeita NUL interno. Valide antes do FFI.
• Documente o tempo de vida dos ponteiros passados para C. Quem libera?
• Redija segredos em logs Display/Debug. Implementações personalizadas.
• Valide a entrada de análise; não use unwrap em dados do usuário. Retorne Result.
• Sanitize antes da invocação do shell. Não apenas regex.

FAQs

Relacionado

• Noções Básicas de Strings
• UTF-8 e Indexação
• Cow
• Noções Básicas de Módulos

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