#box #move #replace #reuse #take

empty-box

Allows for Boxs to have their values moved out and replaced with new values, while reusing the same allocation

2 releases

Uses old Rust 2015

0.1.1 Jun 1, 2017
0.1.0 Jun 1, 2017

#604 in Memory management

MIT/Apache

7KB
69 lines

Build Status Docs Status On crates.io

EmptyBox, a way to safely move values in and out of Boxs 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

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.

No runtime deps