Struct parallel_disk_usage::args::fraction::Fraction

pub struct Fraction(_);

Floating-point value that is greater than or equal to 0 and less than 1.

Implementations

impl Fraction

pub fn new(value: f32) -> Result<Self, ConversionError>

Create a Fraction.

Methods from Deref<Target = f32>

pub const RADIX: u32

pub const MANTISSA_DIGITS: u32

pub const DIGITS: u32

pub const EPSILON: f32

pub const MIN: f32

pub const MIN_POSITIVE: f32

pub const MAX: f32

pub const MIN_EXP: i32

pub const MAX_EXP: i32

pub const MIN_10_EXP: i32

pub const MAX_10_EXP: i32

pub const NAN: f32

pub const INFINITY: f32

pub const NEG_INFINITY: f32

pub fn total_cmp(&self, other: &f32) -> Ordering

🔬 This is a nightly-only experimental API. (total_cmp)

Returns an ordering between self and other values. Unlike the standard partial comparison between floating point numbers, this comparison always produces an ordering in accordance to the totalOrder predicate as defined in IEEE 754 (2008 revision) floating point standard. The values are ordered in following order:

• Negative quiet NaN
• Negative signaling NaN
• Negative infinity
• Negative numbers
• Negative subnormal numbers
• Negative zero
• Positive zero
• Positive subnormal numbers
• Positive numbers
• Positive infinity
• Positive signaling NaN
• Positive quiet NaN

Note that this function does not always agree with the PartialOrd and PartialEq implementations of f32. In particular, they regard negative and positive zero as equal, while total_cmp doesn’t.

Example

#![feature(total_cmp)]
struct GoodBoy {
    name: String,
    weight: f32,
}

let mut bois = vec![
    GoodBoy { name: "Pucci".to_owned(), weight: 0.1 },
    GoodBoy { name: "Woofer".to_owned(), weight: 99.0 },
    GoodBoy { name: "Yapper".to_owned(), weight: 10.0 },
    GoodBoy { name: "Chonk".to_owned(), weight: f32::INFINITY },
    GoodBoy { name: "Abs. Unit".to_owned(), weight: f32::NAN },
    GoodBoy { name: "Floaty".to_owned(), weight: -5.0 },
];

bois.sort_by(|a, b| a.weight.total_cmp(&b.weight));

Trait Implementations

impl AsRef<f32> for Fraction

fn as_ref(&self) -> &f32

Performs the conversion.

impl Clone for Fraction

fn clone(&self) -> Fraction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Fraction

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

Formats the value using the given formatter.

impl Default for Fraction

fn default() -> Fraction

Returns the “default value” for a type.

impl Deref for Fraction

type Target = f32

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Display for Fraction

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

Formats the value using the given formatter.

impl From<Fraction> for f32

fn from(original: Fraction) -> Self

Performs the conversion.

impl FromStr for Fraction

type Err = FromStrError

The associated error which can be returned from parsing.

fn from_str(text: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq<Fraction> for Fraction

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<Fraction> for Fraction

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

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

#[must_use]

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

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

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

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

#[must_use]

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

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

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

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

impl TryFrom<f32> for Fraction

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: f32) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Fraction

impl StructuralPartialEq for Fraction