David's Blog

Rust's Match Syntax for Pattern Matching A Comprehensive Guide

By David Li on 2024-10-17T02:21:56.000Z

Rust’s Match Syntax for Pattern Matching: A Comprehensive Guide

Pattern matching is a powerful feature found in many programming languages, and Rust is no exception. In this article, we’ll dive deep into Rust’s match syntax and explore various ways to utilize it for elegant and efficient pattern matching.


Pattern matching in Rust is achieved using the match expression, which allows you to compare a value against a series of patterns and execute a block of code for the first pattern that matches. The syntax for a basic match expression looks like this:

match VALUE {
    // ...

The _ pattern is a catch-all pattern, which will match any value. It’s essential to have this catch-all arm to ensure that all cases are covered, as Rust enforces exhaustive pattern matching.

Basic Pattern Matching

Let’s start with a simple example. Suppose we have an enum representing different shapes, and we want to calculate their area:

enum Shape {
    Circle(f64),      // radius
    Rectangle(f64, f64), // width, height
    Square(f64),       // side

fn area(shape: Shape) -> f64 {
    match shape {
        Shape::Circle(radius) => std::f64::consts::PI * radius * radius,
        Shape::Rectangle(width, height) => width * height,
        Shape::Square(side) => side * side,

Here, we match the input shape against the different variants of the Shape enum. Note how we can destructure the values associated with each variant directly in the pattern.

Using Guards

Guards are an additional, optional condition that must be satisfied for a pattern to match. They are introduced using the if keyword, followed by an expression that evaluates to a boolean value. Here’s an example that demonstrates the use of guards:

fn number_type(n: i32) -> &'static str {
    match n {
        x if x < 0 => "negative",
        0 => "zero",
        x if x > 0 => "positive",
        _ => unreachable!(),

In this example, we use guards to differentiate between negative and positive numbers. The _ pattern with unreachable!() macro is used here just to satisfy the exhaustive pattern matching requirement, but it’s not actually reachable.

Matching Ranges

You can use ranges in patterns to match a range of values. Ranges are created using the .. or ..= syntax. The former creates an exclusive range, while the latter creates an inclusive range. Here’s an example that demonstrates how to use ranges to match a grade based on a score:

fn grade(score: u32) -> &'static str {
    match score {
        0..=59 => "F",
        60..=69 => "D",
        70..=79 => "C",
        80..=89 => "B",
        90..=100 => "A",
        _ => unreachable!(),

Using @ to Bind Names to Values

The @ syntax allows you to bind a name to a value in a pattern. This can be useful for situations where you want to both destructure a value and use it in an expression. Consider the following example that demonstrates this feature:

enum Message {
    Hello { id: i32 },

fn process_message(msg: Message) {
    match msg {
        Message::Hello { id: id @ 0..=100 } => println!("Special Hello to id {}", id),
        Message::Hello { id } => println!("Regular Hello to id {}", id),

In this example, we use the @ syntax to bind the id value to the id variable if it’s in the range of 0 to 100. This allows us to use the id value in the expression that follows.

Matching Multiple Patterns

You can match multiple patterns at once using the | operator. This can be useful for situations where you want to execute the same code for different patterns. Here’s an example that demonstrates this feature:

enum Color {

fn is_primary_color(color: Color) -> bool {
    match color {
        Color::Red | Color::Green | Color::Blue => true,
        _ => false,

In this example, we use the | operator to match all primary colors and return true.


Rust’s match syntax offers a powerful and flexible way to perform pattern matching in your code. By understanding and leveraging its various features, you can write more expressive and efficientRust programs. In this article, we covered basic pattern matching, guards, ranges, binding names to values using @, and matching multiple patterns using the | operator. These are just a few of the many ways Rust’s match syntax can be used to make your code more elegant and maintainable. As you gain more experience with Rust, you’ll discover even more ways to harness the power of pattern matching to write robust and efficient code.

© Copyright 2024 by FriendlyUsers Tech Blog. Built with ♥ by FriendlyUser. Last updated on 2024-06-14.