cold_path in core::hint - Rust
Description: Hints to the compiler that given path is cold, i.e., unlikely to be taken. The compiler may choose to optimize paths that are not cold at the expense of paths that are cold.

# Function cold_path

Source

    pub const fn cold_path()

🔬This is a nightly-only experimental API. (`cold_path` #136873)
Expand description

Hints to the compiler that given path is cold, i.e., unlikely to be taken. The compiler may choose to optimize paths that are not cold at the expense of paths that are cold.

## §Examples

    #![feature(cold_path)]
    use core::hint::cold_path;

    fn foo(x: &[i32]) {
        if let Some(first) = x.get(0) {
            // this is the fast path
        } else {
            // this path is unlikely
            cold_path();
        }
    }

    fn bar(x: i32) -> i32 {
        match x {
            1 => 10,
            2 => 100,
            3 => { cold_path(); 1000 }, // this branch is unlikely
            _ => { cold_path(); 10000 }, // this is also unlikely
        }
    }