O que é um 'Result'?

Enquanto Option lida com a ausência de valores, Rust oferece outro enum para um cenário diferente, mas igualmente importante: operações que podem falhar. Conheça Result<T, E> — a principal ferramenta do Rust para lidar com erros recuperáveis.

A enum Result tem duas variantes que representam o resultado de uma operação:

enum Result<T, E> {
    Ok(T),    // Sucesso - contém o resultado bem-sucedido
    Err(E),   // Falha - contém informações de erro
}

Quando uma operação é bem-sucedida, ela retorna Ok(value) contendo o resultado de sucesso. Quando ela falha, ela retorna Err(error) contendo informações sobre o que deu errado. Este tratamento explícito de casos de sucesso e falha torna os programas em Rust mais confiáveis e previsíveis.

Você encontrará Result em todos os lugares no Rust - desde operações de arquivo que podem falhar devido a arquivos ausentes, até requisições de rede que podem expirar, até operações de parsing que podem receber entradas inválidas. Ao contrário de linguagens que usam exceções, o Rust força você a reconhecer que as operações podem falhar e a lidar com ambos os resultados explicitamente.