Struct darc::Rc

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

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.

Implementations

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> AsRef<T> for Rc<T>

fn as_ref(&self) -> &T

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

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

fn borrow(&self) -> &T

Immutably borrows from an owned value.

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: ?Sized + Debug> Debug for Rc<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Rc<T>

fn default() -> Self

Returns the “default value” for a type.

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

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

impl<T: ?Sized + Display> Display for Rc<T>

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

Formats the value using the given formatter.

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

fn drop(&mut self)

Executes the destructor for this type.

impl<T> From<T> for Rc<T>

fn from(data: T) -> Self

Converts to this type from the input type.

impl<T: ?Sized + Hash> Hash for Rc<T>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: ?Sized + Ord> Ord for Rc<T>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl<T: ?Sized + PartialEq> PartialEq<Rc<T>> for Rc<T>

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Self) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: ?Sized + PartialOrd> PartialOrd<Rc<T>> for Rc<T>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Self) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Self) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Self) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Self) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

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

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

Formats the value using the given formatter.

impl<T: ?Sized + Eq> Eq for Rc<T>

impl<T: RefUnwindSafe + ?Sized> UnwindSafe for Rc<T>