#optimization #hint #likely #intrinsics #performance

no-std likely_stable

likely and unlikely compiler hints in stable rust

1 unstable release

0.1.2 Mar 9, 2021
0.1.1 Mar 9, 2021
0.1.0 Mar 9, 2021

#1011 in Hardware support

Download history 284/week @ 2023-02-02 379/week @ 2023-02-09 267/week @ 2023-02-16 399/week @ 2023-02-23 228/week @ 2023-03-02 242/week @ 2023-03-09 506/week @ 2023-03-16 663/week @ 2023-03-23 391/week @ 2023-03-30 325/week @ 2023-04-06 409/week @ 2023-04-13 636/week @ 2023-04-20 401/week @ 2023-04-27 420/week @ 2023-05-04 236/week @ 2023-05-11 380/week @ 2023-05-18

1,543 downloads per month
Used in 4 crates

MIT/Apache

29KB
675 lines

LICENSE LICENSE Documentation Crates.io Version

This crates brings likely and unlikely branch prediction hints to stable rust

use likely_stable::{likely,unlikely};
use rand::random;

if likely(random::<i32>() > 10) {
    println!("likely!")
} else {
    println!("unlikely!")
}

It also provides if_likely and if_unlikely for branch prediction for if let statements.

use likely_stable::if_likely;
use rand::random;

let v = Some(random()).filter(|v:&i32| *v > 10);

if_likely!{let Some(v) = v => {
    println!("likely!")
} else {
    println!("unlikely!")
}};

Moreover traits LikelyBool, LikelyOption and LikelyResult provides likely and unlikely versions of the methods commonly used for types bool, Option and Result

use likely_stable::LikelyOption;
use rand::random;

let v = Some(random()).filter(|v:&i32| *v > 10);

v.map_or_else_likely(
    || println!("unlikely"),
    |v| println!("likely {}",v));

Usage

Add this to your Cargo.toml:

[dependencies]
likely_stable = "0.1"

Dependencies

~160KB