Option Combinators

Option provides combinators to transform and chain optional values without nested match.

Recipe

fn port_from_env() -> Option<u16> {
    std::env::var("PORT").ok()
        .and_then(|s| s.parse().ok())
}

When to reach for this: Pipelines where absence is normal, not an error requiring Result.

Working Example

struct User { name: String, nickname: Option<String> }
 
fn display_name(u: &User) -> String {
    u.nickname.as_ref()
        .map(|n| format!("{} ({})", u.name, n))
        .unwrap_or_else(|| u.name.clone())
}
 
fn main() {
    let u = User { name: "Ada".into(), nickname: Some("ad".into()) };
    println!("{}", display_name(&u));
}

What this demonstrates:

• map / as_ref avoid moving
• unwrap_or_else lazy default
• Optional field handling without panic

Deep Dive

Key methods: map, and_then, filter, or, or_else, unwrap_or, unwrap_or_default, ok_or, transpose, zip.

Gotchas

• unwrap in production - Panics on None. Fix: unwrap_or or ? with ok_or.
• Moving with map on owned Option - Consumes. Fix: as_ref/as_mut.
• Nested Option<Option<T>> - flatten (1.29+).
• Confusing and vs and_then - and replaces with constant Option. Fix: Read docs per method.
• Option vs Result - Use ok_or when absence is error.

Alternatives

FAQs

Related

• Option & Result as Enums
• if let, let else & while let
• The ? Operator
• Fallible Iterators & collect()

Stack versions: This page was written for Rust 1.97.0 (edition 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, and Polars 0.46+.