unsafe_unwrap

A Rust library that enables unchecked unwrapping on Option and Result types.

Usage

The unsafe_unwrap() method can be used anywhere unwrap() is used. It behaves similar to unwrap() in unoptimized builds and will remove checks in optimized builds.

extern crate unsafe_unwrap;
use unsafe_unwrap::UnsafeUnwrap;

let x = Some(42);
let y = unsafe { x.unsafe_unwrap() };

Benchmark

License

This project is released under either:

• MIT License

• Apache License (Version 2.0)

at your choosing.

lib.rs:

Provides a way to quickly yet unsafely unwrap types whose inner values are known to exist.

By calling unsafe_unwrap(), the compiler is told, in optimized builds, that the unwrap will never fail. In debug builds it will emit a panic.

Sometimes the optimizer can remove checked unwrapping if it can prove that a value exists. However, in times that it may not be able to do so, this works as an alternative.

This is akin to the unsafelyUnwrapped property of Optional in Swift.

Examples

use unsafe_unwrap::UnsafeUnwrap;

let x = Some(20);
let y = unsafe { x.unsafe_unwrap() };