Trait RefCount 

pub trait RefCount {
    type Value;

    // Required methods
    fn one() -> Self;
    fn is_one(val: &Self::Value) -> bool;
    fn load_acquire(&self) -> Self::Value;
    fn fence_acquire(&self);
    fn fetch_inc_relaxed(&self) -> Self::Value;
    fn fetch_dec_release(&self) -> Self::Value;
}

Trait for refcount

Some method names explain required memory ordering in multi-threaded context.

Required Associated Types

type Value

Type of count

Required Methods

fn one() -> Self

Creates a new RefCount object.

The object is initialized as “one”.

fn is_one(val: &Self::Value) -> bool

Checks whether a value equals to one.

fn load_acquire(&self) -> Self::Value

Gets a current value.

Memory ordering

Acquire or stronger ordering is required if implementors are atomic types.

fn fence_acquire(&self)

Memory fence.

This method is needed only for multi-threaded refcount. In single-threaded implementors, this can be NO-OP.

Memory ordering

Acquire or stronger ordering is required if implementors are atomic types.

fn fetch_inc_relaxed(&self) -> Self::Value

Increments its value and returns previous value.

Memory ordering

Relaxed ordering is allowed if implementors are atomic types.

fn fetch_dec_release(&self) -> Self::Value

Decrements its value and returns previous value.

Memory ordering

Release or stronger ordering is required if implementors are atomic types.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl RefCount for Cell<u8>

type Value = u8

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

impl RefCount for Cell<u16>

type Value = u16

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

impl RefCount for Cell<u32>

type Value = u32

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

impl RefCount for Cell<u64>

type Value = u64

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

impl RefCount for Cell<usize>

type Value = usize

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

impl RefCount for AtomicU8

type Value = u8

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

impl RefCount for AtomicU16

type Value = u16

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

impl RefCount for AtomicU32

type Value = u32

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

impl RefCount for AtomicU64

type Value = u64

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

impl RefCount for AtomicUsize

type Value = usize

fn one() -> Self

fn is_one(val: &Self::Value) -> bool

fn load_acquire(&self) -> Self::Value

fn fence_acquire(&self)

fn fetch_inc_relaxed(&self) -> Self::Value

fn fetch_dec_release(&self) -> Self::Value

Implementors