Struct Rate 

pub struct Rate(/* private fields */);

A non-negative, finite “units per second” value.

The unit itself (bytes, packets, operations) is implied by the field the rate is stored in. Rates are calculated, so floating point is permitted (§10.4).

A rate can only be constructed from a validated delta: Rate::new rejects negatives, so a counter reset cannot silently become a huge or negative rate (§8.2).

Implementations

impl Rate

pub const ZERO: Self

Zero units per second.

pub fn new(per_second: f64) -> Option<Self>

Builds a rate, rejecting NaN, infinities, and negative values.

pub fn from_delta(delta: u64, elapsed: Duration) -> Option<Self>

Builds a rate from a validated non-negative delta and the actual elapsed time.

Never assume a one-second interval: suspend/resume, load, and scheduler delay all make the real interval variable (§8.1). Returns None when elapsed is zero or the result is not finite.

pub const fn per_second(self) -> f64

The underlying units-per-second value.

pub fn delta_from(self, other: Self) -> f64

Signed difference against another rate, for comparison columns (§2.5).

Trait Implementations

impl Clone for Rate

fn clone(&self) -> Rate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Rate

impl Debug for Rate

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

Formats the value using the given formatter.

impl Default for Rate

fn default() -> Rate

Returns the “default value” for a type.

impl Display for Rate

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

Formats the value using the given formatter.

impl PartialEq for Rate

fn eq(&self, other: &Rate) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for Rate

fn partial_cmp(&self, other: &Rate) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Rate