Copies a Ref.

The MuCell is already immutably borrowed, so this cannot fail.

This is an associated function that needs to be used as Ref::clone(...). A Clone implementation or a method would interfere with the widespread use of r.borrow().clone() to clone the contents of a MuCell.

Consumes the Ref, returning the wrapped value.

The 'static constraint on T is what makes this possible; there is no longer any need to keep the borrow alive, and so the Ref itself can be consumed while keeping the contained value.

Examples

use mucell::{MuCell, Ref};
use std::borrow::Cow;

let c = MuCell::new("foo");

let r1: Ref<Cow<str>> = Ref::map(c.borrow(), |s| Cow::from(*s));
let r2: Ref<String> = Ref::map(r1, |s| s.into_owned());
let string: String = r2.into_inner();

Make a new Ref for a component of the borrowed data.

The MuCell is already immutably borrowed, so this cannot fail.

This is an associated function that needs to be used as Ref::map(...). A method would interfere with methods of the same name on the contents of a MuCell used through Deref.

Example

use mucell::{MuCell, Ref};

let c = MuCell::new((5, 'b'));
let b1: Ref<&(u32, char)> = c.borrow();
let b2: Ref<&u32> = Ref::map(b1, |t| &t.0);
assert_eq!(*b2, 5)

Make a new Ref for a optional component of the borrowed data, e.g. an enum variant.

The MuCell is already immutably borrowed, so this cannot fail.

This is an associated function that needs to be used as Ref::filter_map(...). A method would interfere with methods of the same name on the contents of a MuCell used through Deref.

Example

use mucell::{MuCell, Ref};

let c = MuCell::new(Ok(5));
let b1: Ref<&Result<u32, ()>> = c.borrow();
let b2: Ref<&u32> = Ref::filter_map(b1, |o| o.as_ref().ok()).unwrap();
assert_eq!(*b2, 5)

The resulting type after dereferencing

The method called to dereference a value