Structs, enums e traits

Rust Pattern Matching with match

Compare a value against values, ranges, tuples and guards, and let the compiler check you covered everything.

  • Intermediário
  • 3 min de leitura
  • 1 exemplo executável
O que você vai aprender
  • match arms
  • Ranges, | and guards
  • if let
match n
0"zero"
1 | 2 | 3"small"
4..=9"medium"
_"large"

The first pattern that fits wins

match compares a value with a list of patterns and runs the first one that fits. Patterns can be single values, several values, ranges, tuples, or a name that catches everything else.

1 | 2 | 3 matches any of the three values and 4..=9 matches a range. n if n < 0 is a guard: the pattern matches only when the condition is true. _ catches everything that is left. if let is a short match for a single pattern.

Pontos-chave

  1. 1 | 2 | 3 matches any of the three.
  2. 4..=9 matches a range.
  3. _ catches everything else.

Exemplo executável de Rust

Rust
Executar código →
main.rs
fn classify(n: i32) -> &'static str {
    match n {
        0 => "zero",
        1 | 2 | 3 => "small",
        4..=9 => "medium",
        n if n < 0 => "negative",
        _ => "large",
    }
}

fn main() {
    for n in [0, 2, 7, -5, 42] {
        println!("{n}: {}", classify(n));
    }

    let point = (0, 8);
    match point {
        (0, y) => println!("on the y axis at {y}"),
        (x, 0) => println!("on the x axis at {x}"),
        (x, y) => println!("at ({x}, {y})"),
    }

    let maybe = Some(3);
    if let Some(value) = maybe {
        println!("got {value}");
    }
}
Gerar um botão Run para este exemplo Resultado da execução
0: zero
2: small
7: medium
-5: negative
42: large
on the y axis at 8
got 3

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: Temperature Converter →

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