#enums #portable-atomic #atomic #atomic-enum

portable_atomic_enum

An attribute to create an portable atomic wrapper around a C-style enum

6 releases

0.3.1 Mar 3, 2024
0.3.0 Nov 14, 2023
0.2.0 Nov 13, 2023
0.1.2 Oct 18, 2023

#260 in Concurrency

Download history 854/week @ 2024-12-25 2700/week @ 2025-01-01 4403/week @ 2025-01-08 5503/week @ 2025-01-15 3813/week @ 2025-01-22 3681/week @ 2025-01-29 4818/week @ 2025-02-05 4401/week @ 2025-02-12 2831/week @ 2025-02-19 2624/week @ 2025-02-26 3097/week @ 2025-03-05 2707/week @ 2025-03-12 2625/week @ 2025-03-19 2754/week @ 2025-03-26 3448/week @ 2025-04-02 3430/week @ 2025-04-09

12,829 downloads per month
Used in 4 crates (via esp-wifi)

MIT license

6KB

cargo version docs.rs version

portable_atomic_enum

This crate is a fork of atomic_enum and optionally uses portable-atomic to support more targets.

An attribute to create an atomic wrapper around a C-style enum.

Internally, the generated wrapper uses an AtomicUsize to store the value. The atomic operations have the same semantics as the equivalent operations of AtomicUsize.

Example

# use atomic_enum::atomic_enum;
# use std::sync::atomic::Ordering;
#[atomic_enum]
#[derive(Clone, Copy, Debug, PartialEq)]
enum CatState {
    Dead = 0,
    BothDeadAndAlive,
    Alive,
}

let state = AtomicCatState::new(CatState::Dead);
state.store(CatState::Alive, Ordering::Relaxed);
assert_eq!(state.load(Ordering::Relaxed), CatState::Alive);

This attribute does not use or generate any unsafe code.

The crate can be used in a #[no_std] environment.

Cargo features

  • portable-atomic: polyfill atomic types using portable-atomic

Dependencies

~0.2–1MB
~20K SLoC