Struct LockFreeCounter 

pub struct LockFreeCounter { /* private fields */ }

A lock-free atomic counter with fetch-add, fetch-sub, and CAS operations.

This is a thin wrapper around AtomicUsize that provides a clean API for concurrent counting.

Implementations

impl LockFreeCounter

pub fn new(initial: usize) -> Self

Create a new counter initialised to initial.

pub fn increment(&self) -> usize

Atomically increment and return the previous value.

pub fn decrement(&self) -> usize

Atomically decrement and return the previous value.

Saturates at zero (will not wrap).

pub fn get(&self) -> usize

Get the current value.

pub fn add(&self, n: usize) -> usize

Atomically add n and return the previous value.

pub fn compare_and_swap( &self, expected: usize, new_val: usize, ) -> Result<usize, usize>

Compare-and-swap: if current value equals expected, set to new_val.

Returns Ok(expected) on success, Err(actual) on failure.

pub fn reset(&self) -> usize

Reset the counter to zero and return the previous value.

Trait Implementations

impl Debug for LockFreeCounter

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

Formats the value using the given formatter.

impl Default for LockFreeCounter

fn default() -> Self

Returns the “default value” for a type.