semisafe 0.1.0

Semi-safe utilities for performance-critical 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

/// Returns success value inside `res` without `Err` checks in release builds.
///
/// Use this only when surrounding code guarantees that `res` is `Ok(_)`.
/// In debug builds this delegates to [`Result::unwrap`] so invariant
/// violations panic with error value. In release builds, passing `Err(_)`
/// causes undefined behavior.
///
/// # Panics
///
/// Panics in debug builds if `res` is `Err(_)`.
///
/// # Examples
///
/// ```
/// let value = semisafe::result::unwrap::<_, &str>(Ok(42));
/// assert_eq!(value, 42);
/// ```
#[inline(always)]
pub fn unwrap<T, E: std::fmt::Debug>(res: Result<T, E>) -> T {
    #[cfg(debug_assertions)]
    {
        res.unwrap()
    }

    #[cfg(not(debug_assertions))]
    {
        unsafe { res.unwrap_unchecked() }
    }
}