Struct darc::Rc

pub struct Rc<T: ?Sized> { /* fields omitted */ }

A reference-counted pointer. 'Rc' stands for 'Reference Counted'.

This may or may not use atomic access for the reference count, depending on whether it is ever converted to an Arc.

Methods

impl<T> Rc<T>

pub fn new(data: T) -> Self

Constructs a new Rc<T>.

This is initially single-threaded, so updates to the reference count will use non-atomic access. If an Arc is ever created from this instance, this will cause all of its references to start using atomic access to the reference count.

pub fn from_arc(arc: Arc<T>) -> Self

Converts an Arc<T> to Rc<T>. This does not change its atomic property.

pub fn unshare(this: &Self) -> bool

Attempts to convert this to an unsynchronized pointer, no longer atomic. Returns true if successful, or false if there are still potentially references on other threads.

Trait Implementations

impl<T: ?Sized> Drop for Rc<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: ?Sized> Clone for Rc<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> From<T> for Rc<T>

fn from(data: T) -> Self

Performs the conversion.

impl<T: ?Sized> Deref for Rc<T>

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.