push-while-ref 0.1.1

push while having a reference
Documentation
  • Coverage
  • 56.25%
    9 out of 16 items documented5 out of 15 items with examples
  • Size
  • Source code size: 21.6 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 2.14 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Links
  • soerenmeier/push-while-ref
    0 0 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • soerenmeier

A crate to enable holding a reference while still being able to push.
This is possible if you have another lifetime just for storing data (here called Owner).

The data that is inserted needs to not move in memory, because if the container (Vec, HashMap...) needs to reallocate that would invalidate the reference. this is garantie is give by the trait StaticType.

Example pushing

use push_while_ref::{VecOwner, VecChild};

let mut vec = VecOwner::new();
let mut vec = vec.child();
let v1 = vec.push(Box::new(10));
let v2 = vec.push(Box::new(20));
assert_eq!(*v1, 10);
assert_eq!(*v2, 20);

Example inserting

use push_while_ref::{HashMapOwner, HashMapChild};

let mut map = HashMapOwner::new();
let mut map = map.child();
let v1 = map.insert("10", Box::new(10));
let v2 = map.insert("20", Box::new(20));
assert_eq!(*v1, 10);
assert_eq!(*v2, 20);