#portable-atomic #atomic #enums #c-style #operations #attributes #create

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

#201 in Concurrency

Download history 4831/week @ 2024-11-16 3419/week @ 2024-11-23 2843/week @ 2024-11-30 2052/week @ 2024-12-07 3895/week @ 2024-12-14 951/week @ 2024-12-21 1372/week @ 2024-12-28 4244/week @ 2025-01-04 5614/week @ 2025-01-11 3936/week @ 2025-01-18 3848/week @ 2025-01-25 4619/week @ 2025-02-01 4537/week @ 2025-02-08 3280/week @ 2025-02-15 2505/week @ 2025-02-22 3622/week @ 2025-03-01

15,027 downloads per month
Used in 3 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