Struct xarc::Xarc

pub struct Xarc<T: Send + Sync> { /* fields omitted */ }

Xarc is an atomic smart pointer.

Implementations

impl<T: Send + Sync> Xarc<T>

pub fn new(value: T) -> Self

Initialize the atomic smart pointer with value.

pub fn null() -> Self

Initialize the atomic smart pointer with null.

pub fn compare_and_swap(
    &self,
    current: &XarcLocal<T>,
    new: &XarcLocal<T>,
    order: Ordering
) -> XarcLocal<T>

As an atomic operation, if self == current swap the contents of self with new. Returns the previous value of self. If the value does not equal current the operation failed.

pub fn compare_exchange(
    &self,
    current: &XarcLocal<T>,
    new: &XarcLocal<T>,
    success: Ordering,
    failure: Ordering
) -> Result<XarcLocal<T>, XarcLocal<T>>

As an atomic operation, if self == current swap the contents of self with new. Returns the previous value of self in a Result indicating whether the operation succeeded or failed.

pub fn compare_exchange_weak(
    &self,
    current: &XarcLocal<T>,
    new: &XarcLocal<T>,
    success: Ordering,
    failure: Ordering
) -> Result<XarcLocal<T>, XarcLocal<T>>

As an atomic operation, if self == current swap the contents of self with new. Returns the previous value of self in a Result indicating whether the operation succeeded or failed. Failure does not necessarily imply that self != current. This is typically called within a loop.

pub fn try_load(&self, order: Ordering) -> Result<XarcLocal<T>, ()>

Attempt to load the value into an XarcLocal. It can fail if, after the pointer has been loaded but before it is used, it is swapped out in another thread and destroyed. If success is required, use XarcLocal::from instead.

Trait Implementations

impl<T: Debug + Send + Sync> Debug for Xarc<T>

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

Formats the value using the given formatter.

impl<T: Send + Sync> Default for Xarc<T>

fn default() -> Self

Returns the "default value" for a type.

impl<T: Send + Sync> Drop for Xarc<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: Send + Sync, '_> From<&'_ Xarc<T>> for XarcLocal<T>

fn from(shared: &Xarc<T>) -> Self

Performs the conversion.