Enum AutoWaitStrategy 

pub enum AutoWaitStrategy {
    BusySpin,
    BusySpinWithSpinLoopHint,
    SpinThenYield {
        spins: usize,
    },
    Sleep(Duration),
    Block,
}

Wait strategy for automatic event handlers

Variants

BusySpin

Maximum performance busy spinning (100% CPU usage) - true busy spin, no hints

BusySpinWithSpinLoopHint

High performance busy spinning with spin loop hints (slightly lower CPU usage)

SpinThenYield

Hybrid: spin N iterations, then yield the thread

Fields

spins: usize

Number of spin-loop iterations before yielding once.

Sleep(Duration)

CPU efficient with configurable sleep duration

Block

Blocking with efficient waiting (balanced performance/CPU)

Implementations

impl AutoWaitStrategy

pub fn high_performance() -> Self

Create a high performance wait strategy (true busy spin)

pub fn high_performance_with_hints() -> Self

Create a high performance wait strategy with spin loop hints

pub fn spin_then_yield(spins: usize) -> Self

Create a hybrid strategy that spins N times then yields

pub fn cpu_efficient() -> Self

Create a CPU efficient wait strategy

pub fn sleep(duration: Duration) -> Self

Create a custom sleep-based wait strategy

pub fn sleep_nanos(nanos: u64) -> Self

Create a sleep-based wait strategy with nanosecond precision

Special Values

• 0 = use spin_loop() instead of sleep (high performance)
• 1.. = Sleep for the specified nanoseconds (lower performance, CPU efficient)

Note: Actual sleep precision depends on the operating system. Very small durations (< 1000ns) may not sleep at all on some systems.

pub fn sleep_micros(micros: u64) -> Self

Create a sleep-based wait strategy with microsecond precision

Special Values

• 0 = use spin_loop() instead of sleep (high performance)
• 1.. = Sleep for the specified microseconds (lower performance, CPU efficient)

pub fn from_env_or(default: AutoWaitStrategy) -> Self

Create wait strategy from environment variables with fallback

Checks these environment variables in order:

1. MYELON_AUTO_WAIT_DELAY_NS - nanosecond precision (0 = spin_loop)
2. MYELON_AUTO_WAIT_DELAY_US - microsecond precision (0 = spin_loop)
3. Falls back to the provided default

Examples

# Use spin_loop (maximum performance)
export MYELON_AUTO_WAIT_DELAY_NS=0

# Sleep for 100 nanoseconds
export MYELON_AUTO_WAIT_DELAY_NS=100

# Sleep for 10 microseconds
export MYELON_AUTO_WAIT_DELAY_US=10

Trait Implementations

impl Clone for AutoWaitStrategy

fn clone(&self) -> AutoWaitStrategy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AutoWaitStrategy

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

Formats the value using the given formatter.

impl Default for AutoWaitStrategy

fn default() -> AutoWaitStrategy

Returns the “default value” for a type.