Struct Gauge 

#[repr(align(64))]
pub struct Gauge { /* private fields */ }

Ultra-fast atomic gauge for f64 values

Uses IEEE 754 bit manipulation for atomic operations on floating-point values. Cache-line aligned to prevent false sharing.

Implementations

impl Gauge

pub fn new() -> Self

Create new gauge starting at zero

pub fn with_value(initial: f64) -> Self

Create gauge with initial value

pub fn set(&self, value: f64)

Set gauge value - THE FASTEST PATH

This is optimized for maximum speed:

• Convert f64 to IEEE 754 bits
• Single atomic store instruction
• Relaxed memory ordering for speed
• Inlined for zero function call overhead

pub fn get(&self) -> f64

Get current value - single atomic load

pub fn add(&self, delta: f64)

Add to current value - atomic read-modify-write loop

Uses compare-and-swap loop for lock-free addition

pub fn sub(&self, delta: f64)

Subtract from current value

pub fn set_max(&self, value: f64)

Set to maximum of current value and new value

pub fn set_min(&self, value: f64)

Set to minimum of current value and new value

pub fn compare_and_swap(&self, expected: f64, new: f64) -> Result<f64, f64>

Atomic compare-and-swap

Returns Ok(previous_value) if successful, Err(current_value) if failed

pub fn reset(&self)

Reset to zero

pub fn multiply(&self, factor: f64)

Multiply current value by factor

pub fn divide(&self, divisor: f64)

Divide current value by divisor

pub fn abs(&self)

Set to absolute value of current value

pub fn clamp(&self, min: f64, max: f64)

Clamp value to range [min, max]

pub fn update_ema(&self, sample: f64, alpha: f64)

Exponential moving average update

new_value = alpha * sample + (1 - alpha) * old_value

pub fn stats(&self) -> GaugeStats

Get comprehensive statistics

pub fn age(&self) -> Duration

Get age since creation

pub fn is_zero(&self) -> bool

Check if gauge is zero

pub fn is_positive(&self) -> bool

Check if value is positive

pub fn is_negative(&self) -> bool

Check if value is negative

pub fn is_finite(&self) -> bool

Check if value is finite (not NaN or infinity)

Trait Implementations

impl Debug for Gauge

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

Formats the value using the given formatter.

impl Default for Gauge

fn default() -> Self

Returns the “default value” for a type.

impl Display for Gauge

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

Formats the value using the given formatter.

impl Send for Gauge

impl Sync for Gauge