oxc_data_structures 0.142.0

A collection of JavaScript tools written in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! `likely` and `unlikely` branch prediction hint functions.
//!
//! Also re-exports [`std::hint::cold_path`].

/// Re-export of [`std::hint::cold_path`].
pub use std::hint::cold_path;

/// Hint to the compiler that the condition `cond` is likely to be `true`.
///
/// No-op at runtime. Just hints to compiler how to arrange code so the likely branch
/// is the default. Any alternative branch is a "cold path".
///
/// Returns `cond` unchanged.
///
/// This is a wrapper around [`std::hint::cold_path`].
/// See documentation for [`std::hint::cold_path`] for more details.
///
/// # Example
/// ```
/// use oxc_data_structures::branch_hints::likely;
///
/// fn char_width(ch: char) -> usize {
///     // Source text is expected to be mostly ASCII
///     if likely(ch.is_ascii()) {
///         1
///     } else {
///         ch.len_utf8()
///     }
/// }
/// ```
//
// `#[inline(always)]` because is no-op at runtime, and would have no effect unless inlined
#[expect(clippy::inline_always)]
#[inline(always)]
pub const fn likely(cond: bool) -> bool {
    if !cond {
        cold_path();
    }
    cond
}

/// Hint to the compiler that the condition `cond` is likely to be `false`.
///
/// No-op at runtime. Just hints to compiler how to arrange code so the likely branch
/// is the default. Any alternative branch is a "cold path".
///
/// Returns `cond` unchanged.
///
/// This is a wrapper around [`std::hint::cold_path`].
/// See documentation for [`std::hint::cold_path`] for more details.
///
/// # Example
/// ```
/// use oxc_data_structures::branch_hints::unlikely;
///
/// fn contains_zero(bytes: &[u8]) -> bool {
///     for &byte in bytes {
///         // Most bytes are expected to be non-zero
///         if unlikely(byte == 0) {
///             return true;
///         }
///     }
///     false
/// }
/// ```
//
// `#[inline(always)]` because is no-op at runtime, and would have no effect unless inlined
#[expect(clippy::inline_always)]
#[inline(always)]
pub const fn unlikely(cond: bool) -> bool {
    if cond {
        cold_path();
    }
    cond
}

#[cfg(test)]
mod test {
    use super::{likely, unlikely};

    #[test]
    fn likely_returns_input_unchanged() {
        assert!(likely(true));
        assert!(!likely(false));
    }

    #[test]
    fn unlikely_returns_input_unchanged() {
        assert!(unlikely(true));
        assert!(!unlikely(false));
    }

    #[test]
    fn usable_in_const_context() {
        const { assert!(likely(true)) };
        const { assert!(!unlikely(false)) };
    }
}