Tratamento de Erros com Retornos Antecipados em Rust

Beginner

This tutorial is from open-source community. Access the source code

Introdução

Neste laboratório, exploramos o conceito de early returns (retornos antecipados) como uma forma de lidar com erros em Rust. O código de exemplo demonstra como podemos usar as instruções match e early returns para tratar erros de forma elegante, tornando o código mais fácil de ler e escrever. Também discutimos as limitações do tratamento explícito de erros e introduzimos o uso do operador ? para casos em que precisamos desembrulhar (unwrap) valores sem arriscar um panic.

Nota: Se o laboratório não especificar um nome de arquivo, você pode usar qualquer nome de arquivo que desejar. Por exemplo, você pode usar main.rs, compilar e executá-lo com rustc main.rs && ./main.

Early returns (Retornos antecipados)

No exemplo anterior, lidamos explicitamente com os erros usando combinadores. Outra forma de lidar com essa análise de casos é usar uma combinação de instruções match e early returns (retornos antecipados).

Ou seja, podemos simplesmente parar de executar a função e retornar o erro se um ocorrer. Para alguns, essa forma de código pode ser mais fácil de ler e escrever. Considere esta versão do exemplo anterior, reescrita usando early returns:

use std::num::ParseIntError;

fn multiply(first_number_str: &str, second_number_str: &str) -> Result<i32, ParseIntError> {
    let first_number = match first_number_str.parse::<i32>() {
        Ok(first_number)  => first_number,
        Err(e) => return Err(e),
    };

    let second_number = match second_number_str.parse::<i32>() {
        Ok(second_number)  => second_number,
        Err(e) => return Err(e),
    };

    Ok(first_number * second_number)
}

fn print(result: Result<i32, ParseIntError>) {
    match result {
        Ok(n)  => println!("n is {}", n),
        Err(e) => println!("Error: {}", e),
    }
}

fn main() {
    print(multiply("10", "2"));
    print(multiply("t", "2"));
}

Neste ponto, aprendemos a lidar explicitamente com erros usando combinadores e early returns. Embora geralmente queiramos evitar panicking (pânico), lidar explicitamente com todos os nossos erros é complicado.

Na próxima seção, introduziremos ? para os casos em que simplesmente precisamos de unwrap (desembrulhar) sem possivelmente induzir um panic.

Resumo

Parabéns! Você concluiu o laboratório de Early Returns (Retornos Antecipados). Você pode praticar mais laboratórios no LabEx para aprimorar suas habilidades.