ExpertiDict

Rust · Essencial · Inglês · Técnico

Result

/rɪˈzʌlt/substantivo

Enum da biblioteca padrão com as variantes Ok(valor) e Err(erro), usado em operações que podem falhar. É o mecanismo normal de erros em Rust, no lugar de exceções.

Onde usar

Funções de I/O, parsing e rede devolvem Result. O compilador avisa quando você ignora um, e o operador ? propaga o erro.

Em código

let r: Result<i32, _> = "42".parse::<i32>();
match r {
  Ok(n) => println!("{n}"),
  Err(e) => println!("erro: {e}"),
}

Exemplos

This function returns a Result.

Essa função devolve um Result.

Don't swallow the Err, log it.

Não engula o Err, registre no log.

Cuidado

Não confunda com panic: Result é para falhas esperadas que o chamador pode tratar, e panic é para bugs.

Veja também

Todos os termos de Rust