Adding `empty_box` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add empty-box

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

empty-box = "0.1.1"

The empty_box library will be automatically available globally. Read the empty_box library documentation.

Back to the crate overview.

Readme

`EmptyBox`, a way to safely move values in and out of `Box`s without

reallocations

EmptyBox is similar to a statically checked Box<Option<T>>:

use empty_box::EmptyBox;

// A box with a string!
let boxed = Box::new("Hello!".to_string());

// Oh no, we don't like that string.
let (string, empty) = EmptyBox::take(boxed);

// Let's make an objectively superior string, and put it into the original
// box.
let superior = "Objectively superior string!".to_string();

// Now we have our superior string in the box!
let boxed = empty.put(superior); 

assert_eq!("Hello!", string);
assert_eq!("Objectively superior string!", &*boxed);

Creating an EmptyBox from a Box and then putting a T back into the EmptyBox will avoid allocating a new Box, instead reusing whatever old Box the T was EmptyBox::taken from.

License

Licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Adding empty_box library as a dependency

Adding `empty_box` library as a dependency