Struct Percent 

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

A non-negative, finite percentage.

Deliberately not clamped to 0..=100: process CPU under the default "core" normalization legitimately exceeds 100% for a multi-threaded process (§8.3). Meters that need a bounded value call Percent::clamped_to_100.

Implementations

impl Percent

pub const ZERO: Self

Zero percent.

pub const FULL: Self

One hundred percent.

pub fn new(value: f32) -> Option<Self>

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

Returning None rather than clamping is intentional: a NaN percentage means the calculation was wrong, and §4 forbids silently converting an unavailable value to a number.

pub fn ratio(part: u64, whole: u64) -> Option<Self>

Builds a percentage from a part / whole ratio.

Returns None when whole is zero, because “0 of 0” has no defined utilization and must be reported as unavailable rather than as 0%.

pub fn clamped_to_100(self) -> Self

Clamps into 0.0..=100.0 for bar and meter rendering.

pub const fn value(self) -> f32

The underlying value.

pub fn fraction(self) -> f32

The value as a 0.0..=1.0-ish fraction (may exceed 1.0).

pub fn points_from(self, other: Self) -> f32

Difference in percentage points, which may be negative.

Trait Implementations

impl Clone for Percent

fn clone(&self) -> Percent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Percent

impl Debug for Percent

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

Formats the value using the given formatter.

impl Default for Percent

fn default() -> Percent

Returns the “default value” for a type.

impl Display for Percent

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

Renders with one decimal only when it adds information (§5.4).

Below 10% a single decimal distinguishes 0.4% from 0.9%; above that the decimal is noise and causes column jitter.

impl PartialEq for Percent

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Percent

fn partial_cmp(&self, other: &Percent) -> 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 Percent