owning-ref-rs

A library for creating references that carry their owner with them.

For more details, see the docs.

Getting Started

owning-ref-rs is available on crates.io. Add the following dependency to your Cargo manifest to get the latest version of the 0.1 branch: ``` [dependencies]

owning_ref = "0.1.*" ```

To always get the latest version, add this git repository to your Cargo manifest:

[dependencies.owning_ref] git = "https://github.com/Kimundi/owning-ref-rs"

Example

```rust extern crate owningref; use owningref::RcRef;

fn main() { // Let's create a few reference counted slices that point to the same memory:

let rc: RcRef<[i32]> = RcRef::new(Rc::new([1, 2, 3, 4]) as Rc<[i32]>);
assert_eq!(&*rc, &[1, 2, 3, 4]);

let rc_a: RcRef<[i32]> = rc.clone().map(|s| &s[0..2]);
let rc_b = rc.clone().map(|s| &s[1..3]);
let rc_c = rc.clone().map(|s| &s[2..4]);
assert_eq!(&*rc_a, &[1, 2]);
assert_eq!(&*rc_b, &[2, 3]);
assert_eq!(&*rc_c, &[3, 4]);

} ```