Struct RcRef

pub struct RcRef<T> { /* private fields */ }

An RcRef encapsulates a reference counted pointer, just like a regular std::rc::Rc. However, unlike a regular Rc, it can be remapped so that it dereferences to any value that’s reachable through the reference-counted pointer. This is achieved through the associated method, RcRef::map(), similar to how std::cell::Ref::map() works. Example:

struct Stuff {
  foo: u32,
  bar: String,
}

let stuff_rc = Rc::new(Stuff {
  foo: 42,
  bar: "hello".to_owned(),
});

// `foo_rc` and `bar_rc` dereference to different types, however
// they share a reference count.
let foo_rc: RcRef<u32> = RcRef::map(stuff_rc.clone(), |v| &v.foo);
let bar_rc: RcRef<String> = RcRef::map(stuff_rc, |v| &v.bar);

Implementations

impl<T> RcRef<AsyncRefCell<T>>

pub fn borrow(&self) -> AsyncRefFuture<T>

pub fn borrow_mut(&self) -> AsyncMutFuture<T>

pub fn try_borrow(&self) -> Option<AsyncRef<T>>

pub fn try_borrow_mut(&self) -> Option<AsyncMut<T>>

impl<T: 'static> RcRef<T>

pub fn new(value: T) -> Self

pub fn map<S: 'static, R: RcLike<S>, F: FnOnce(&S) -> &T>( source: R, map_fn: F, ) -> RcRef<T>

Trait Implementations

impl<T> AsRef<T> for RcRef<T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<T> Borrow<T> for RcRef<T>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<T> Clone for RcRef<T>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for RcRef<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Default + 'static> Default for RcRef<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T> Deref for RcRef<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: 'static> From<&Rc<T>> for RcRef<T>

fn from(rc: &Rc<T>) -> Self

Converts to this type from the input type.

impl<T: 'static> From<&RcRef<T>> for RcRef<T>

fn from(rc_ref: &RcRef<T>) -> Self

Converts to this type from the input type.

impl<T: 'static> From<Rc<T>> for RcRef<T>

fn from(rc: Rc<T>) -> Self

Converts to this type from the input type.

impl<T: 'static> RcLike<T> for &RcRef<T>

impl<T: 'static> RcLike<T> for RcRef<T>