Struct measurements::mass::Mass

pub struct Mass { /* private fields */ }

The Mass struct can be used to deal with mass in a common way. Metric, avoirdupois imperial and troy imperial units are supported.

#Example

use measurements::Mass;

let metric_ton = Mass::from_metric_tons(1.0);
let united_states_tons = metric_ton.as_short_tons();
let united_states_pounds = metric_ton.as_pounds();
println!(
    "One metric ton is {} U.S. tons - that's {} pounds!",
    united_states_tons, united_states_pounds);

Implementations

impl Mass

pub fn from_kilograms(kilograms: f64) -> Self

Create a Mass from a floating point value in kilograms

pub fn from_micrograms(micrograms: f64) -> Self

Create a Mass from a floating point value in micrograms

pub fn from_milligrams(milligrams: f64) -> Self

Create a Mass from a floating point value in milligrams

pub fn from_carats(carats: f64) -> Self

Create a Mass from a floating point value in carats

pub fn from_grams(grams: f64) -> Self

Create a Mass from a floating point value in grams

pub fn from_metric_tons(metric_tons: f64) -> Self

Create a Mass from a floating point value in metric tonnes

pub fn from_tonnes(metric_tons: f64) -> Self

Create a Mass from a floating point value in metric tonnes

pub fn from_grains(grains: f64) -> Self

Create a Mass from a floating point value in grains

pub fn from_pennyweights(pennyweights: f64) -> Self

Create a Mass from a floating point value in pennyweights

pub fn from_ounces(ounces: f64) -> Self

Create a Mass from a floating point value in ounces

pub fn from_troy_ounces(troy_ounces: f64) -> Self

Create a Mass from a floating point value in troy_ounces

pub fn from_pounds(pounds: f64) -> Self

Create a Mass from a floating point value in Pounds (lbs)

pub fn from_troy_pounds(troy_pounds: f64) -> Self

Create a Mass from a floating point value in Troy Pounds

pub fn from_stones(stones: f64) -> Self

Create a Mass from a floating point value in Stone (st.)

pub fn from_short_tons(short_tons: f64) -> Self

Create a Mass from a floating point value in short (US) tons

pub fn from_long_tons(long_tons: f64) -> Self

Create a Mass from a floating point value in long (imperial) tons

pub fn as_micrograms(&self) -> f64

Convert this Mass to a floating point value in micrograms

pub fn as_milligrams(&self) -> f64

Convert this Mass to a floating point value in milligrams

pub fn as_carats(&self) -> f64

Convert this Mass to a floating point value in carats

pub fn as_grams(&self) -> f64

Convert this Mass to a floating point value in grams

pub fn as_kilograms(&self) -> f64

Convert this Mass to a floating point value in kilograms (kg)

pub fn as_metric_tons(&self) -> f64

Convert this Mass to a floating point value in metric Tonnes

pub fn as_tonnes(&self) -> f64

Convert this Mass to a floating point value in metric Tonnes

pub fn as_grains(&self) -> f64

Convert this Mass to a floating point value in Grains

pub fn as_pennyweights(&self) -> f64

Convert this Mass to a floating point value in Pennyweights

pub fn as_ounces(&self) -> f64

Convert this Mass to a floating point value in Ounces (oz)

pub fn as_pounds(&self) -> f64

Convert this Mass to a floating point value in Pounds (lbs)

pub fn as_troy_ounces(&self) -> f64

Convert this Mass to a floating point value in Troy Ounces

pub fn as_troy_pounds(&self) -> f64

Convert this Mass to a floating point value in Troy Pounds

pub fn as_stones(&self) -> f64

Convert this Mass to a floating point value in Stone (st.)

pub fn as_short_tons(&self) -> f64

Convert this Mass to a floating point value in short (US) Tons

pub fn as_long_tons(&self) -> f64

Convert this Mass to a floating point value in long (international) Tons

Trait Implementations

impl Add<Mass> for Mass

type Output = Self

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self

Performs the + operation.

impl Clone for Mass

fn clone(&self) -> Mass

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Mass

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

Formats the value using the given formatter.

impl Display for Mass

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

Formats the value using the given formatter.

impl Div<Density> for Mass

type Output = Volume

The resulting type after applying the / operator.

fn div(self, other: Density) -> Volume

Performs the / operation.

impl Div<Mass> for Mass

type Output = f64

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> f64

Performs the / operation.

impl Div<Mass> for Force

type Output = Acceleration

The resulting type after applying the / operator.

fn div(self, rhs: Mass) -> Self::Output

Performs the / operation.

impl Div<Volume> for Mass

type Output = Density

The resulting type after applying the / operator.

fn div(self, other: Volume) -> Density

Performs the / operation.

impl Div<f64> for Mass

type Output = Self

The resulting type after applying the / operator.

fn div(self, rhs: f64) -> Self

Performs the / operation.

impl Measurement for Mass

fn as_base_units(&self) -> f64

Get this quantity in the base units

fn from_base_units(units: f64) -> Self

Create a new quantity from the base units

fn get_base_units_name(&self) -> &'static str

Return the base unit for this type, as a string. For example “kilograms”

fn get_appropriate_units(&self) -> (&'static str, f64)

Returns a string containing the most appropriate units for this quantity, and a floating point value representing this quantity in those units. Useful when, for example, a length might be in millimeters if it is very small, or kilometers when it is very large.

fn pick_appropriate_units(
    &self,
    list: &[(&'static str, f64)]
) -> (&'static str, f64)

Given a list of units and their scale relative to the base unit, select the most appropriate one.

impl Mul<Acceleration> for Mass

type Output = Force

The resulting type after applying the * operator.

fn mul(self, rhs: Acceleration) -> Self::Output

Performs the * operation.

impl Mul<Mass> for f64

type Output = Mass

The resulting type after applying the * operator.

fn mul(self, rhs: Mass) -> Mass

Performs the * operation.

impl Mul<Mass> for Acceleration

type Output = Force

The resulting type after applying the * operator.

fn mul(self, rhs: Mass) -> Self::Output

Performs the * operation.

impl Mul<f64> for Mass

type Output = Self

The resulting type after applying the * operator.

fn mul(self, rhs: f64) -> Self

Performs the * operation.

impl PartialEq<Mass> for Mass

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

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

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

This method tests for !=.

impl PartialOrd<Mass> for Mass

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

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

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

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

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

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

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

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

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 Sub<Mass> for Mass

type Output = Self

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl Copy for Mass

impl Eq for Mass