Trait unchecked_unwrap::UncheckedExpect

source ·

pub trait UncheckedExpect<T> {
    unsafe fn unchecked_expect(self, msg: &str) -> T;
}

Expand description

Trait for unchecked_expect.

Required Methods

source

unsafe fn unchecked_expect(self, msg: &str) -> T

Unwraps an Option or Result, yielding the content of a Some or Ok. This is the unchecked alternative to Option::expect and Result::expect.

Panics

Only panics if the crate features debug_assertions and debug_checks are on.

Panics if the value is a None or Err, with a custom panic message provided by msg and if Result with the content of the Err.

Safety

Callers of this function are responsible that Option or Result carries a Some or Ok.

Failing that, the returned value may reference invalid memory or cause undefined behaviour.

Examples


let x = Some("value");
assert_eq!(unsafe { x.unchecked_expect("the world is ending") }, "value");

let x: Result<u32, &str> = Ok(2);
assert_eq!(unsafe { x.unchecked_expect("the sky is falling down") }, 2);