Rust: enums


2 min read

Table of contents


Enumerations, commonly referred to as enums, are a powerful and expressive feature in the Rust programming language. They allow you to define a type by enumerating its possible variants. With enums, you can represent data that has multiple potential forms or states.

enum Direction {

fn go(direction: Direction) -> &'static str {
    match direction {
        Direction::Up => "up",
        Direction::Down => "down",
        Direction::Left => "left",
        Direction::Right => "right",

fn main() {
    println!("{:?}", go(Direction::Up));

However, the capability of enums doesn't stop at merely defining variants. They can also encapsulate additional data within their variants, allowing them to represent complex data structures succinctly.

enum Mouse {
    Move { x: i32, y: i32 },

// Creating a variant with additional data
let event = Mouse::Scroll(3); // Scroll up by 3 pixels
let move_event = Mouse::Move { x: 3, y: 45 };

The versatility of enums in Rust extends far beyond basic enumeration of values:

  1. Method Association: Enums can have methods associated with them. This is accomplished by implementing methods on enums in a similar fashion to structs, enriching them with behaviour in addition to data representation.

  2. Pattern Matching: Rust's pattern-matching capabilities shine when used with enums. This ensures that you can perform different actions depending on the enum variant, making code clearer and more concise.

  3. Core Types: Enums are at the heart of some of Rust's most essential types. Option<T>, for example, represents a value (Some(T)) or its absence (None). Similarly, Result<T, E> symbolizes a successful result (Ok(T)) or an error (Err(E)). These types, part of Rust's standard library, harness the potency of enums to offer developers safe, expressive ways to handle potential issues or missing data.

In conclusion, enums in Rust play a pivotal role in maintaining type safety, promoting intuitive, and fostering error-resistant coding patterns.