CodeUtility
Tornando o seu trabalho de dev mais simples!
Structs, enums e traits

Rust Error Handling: Result and ?

Errors are values in Rust. Return Result, handle it with match, and pass errors on with ?.

  • Intermediário
  • 3 min de leitura
  • 1 exemplo executável
O que você vai aprender
  • Ok and Err
  • The ? operator
  • Your own error messages
Executar código →
parse_and_double("abc")
  1. 1text.parse()fails
  2. 2?returns early
  3. 3Err(...)the caller gets the error

Success or error, as a value

Rust has no exceptions. A function that can fail returns Result<T, E>, which is either Ok(value) or Err(error). The caller decides what to do with the error.

The ? after parse returns the error to the caller at once when parsing fails; otherwise it gives the number. divide uses a String as its error type and returns Err for a zero divisor. match prints the value or the error message.

Pontos-chave

  1. Result<T, E> is Ok(value) or Err(error).
  2. ? returns the error to the caller at once.
  3. The caller decides what to do.

Exemplo executável de Rust

Rust
Executar código →
main.rs
use std::num::ParseIntError;

fn parse_and_double(text: &str) -> Result<i32, ParseIntError> {
    let number: i32 = text.trim().parse()?; // ? returns the error early
    Ok(number * 2)
}

fn divide(a: i32, b: i32) -> Result<i32, String> {
    if b == 0 {
        return Err(String::from("cannot divide by zero"));
    }
    Ok(a / b)
}

fn main() {
    for input in ["21", "abc"] {
        match parse_and_double(input) {
            Ok(value) => println!("{input} -> {value}"),
            Err(error) => println!("{input} -> error: {error}"),
        }
    }

    println!("{:?}", divide(10, 2));
    println!("{:?}", divide(1, 0));
}
Gerar um botão Run para este exemplo Resultado da execução
21 -> 42
abc -> error: invalid digit found in string
Ok(5)
Err("cannot divide by zero")

Pratique

Abra o exemplo no compilador online, mude um valor ou adicione uma linha e tente prever a saída antes de executar. Depois quebre o código de propósito e leia a mensagem do compilador.

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.

Próxima: Bank Account with Result →

Pratique com um desafio

Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.

Todos os desafios