Struct Mass 

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

A mass quantity, stored canonically in kilograms (kg).

Construction

use space_units::prelude::*;

let m = Mass::from_kg(1000.0);
let m2 = 5.0.kg();             // NumericExt shorthand

Supported units

Constructor	Accessor	Unit
from_kg	in_kg	kilogram (kg)
from_g	in_g	gram (g)
from_lb	in_lb	pound (lb)
from_tonnes	in_tonnes	metric tonne (t)
from_slug	in_slug	slug
from_solar_masses	in_solar_masses	Solar mass (M_sun)
from_earth_masses	in_earth_masses	Earth mass (M_earth)

Typed arithmetic

• Mass × Acceleration → Force
• Mass × Velocity → Momentum
• Mass / Volume → Density
• Mass / Time → MassFlowRate
• Force / Mass → Acceleration
• Momentum / Mass → Velocity
• Energy / Mass → SpecificEnergy

Implementations

impl Mass

pub const fn from_kg(val: f64) -> Self

Create from kilograms (canonical unit).

pub const fn from_g(val: f64) -> Self

Create from grams. 1 g = 0.001 kg.

pub const fn from_lb(val: f64) -> Self

Create from pounds. 1 lb = 0.453 592 37 kg.

pub const fn from_tonnes(val: f64) -> Self

Create from metric tonnes. 1 t = 1 000 kg.

pub const fn from_slug(val: f64) -> Self

Create from slugs. 1 slug = 14.593 903 kg.

pub const fn from_solar_masses(val: f64) -> Self

Create from Solar masses. 1 M_sun = 1.989e30 kg.

pub const fn from_earth_masses(val: f64) -> Self

Create from Earth masses. 1 M_earth = 5.972e24 kg.

pub const fn in_kg(self) -> f64

Get value in kilograms.

pub const fn in_g(self) -> f64

Get value in grams.

pub const fn in_lb(self) -> f64

Get value in pounds.

pub const fn in_tonnes(self) -> f64

Get value in metric tonnes.

pub const fn in_slug(self) -> f64

Get value in slugs.

pub const fn in_solar_masses(self) -> f64

Get value in Solar masses.

pub const fn in_earth_masses(self) -> f64

Get value in Earth masses.

pub fn in_unit(self, unit: MassUnit) -> f64

Get value in the specified MassUnit.

pub fn display_as(self, unit: MassUnit) -> DisplayWithUnit

Return a DisplayWithUnit for formatted printing in the given unit.

pub fn abs(self) -> Self

Absolute value.

Trait Implementations

impl Add for Mass

type Output = Mass

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign for Mass

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Clone for Mass

fn clone(&self) -> Mass

Returns a duplicate 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 Default for Mass

fn default() -> Mass

Returns the “default value” for a type.

impl Display for Mass

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

Formats the value using the given formatter.

impl Div<Mass> for Energy

type Output = SpecificEnergy

The resulting type after applying the / operator.

fn div(self, rhs: Mass) -> SpecificEnergy

Performs the / operation.

impl Div<Mass> for Force

type Output = Acceleration

The resulting type after applying the / operator.

fn div(self, rhs: Mass) -> Acceleration

Performs the / operation.

impl Div<Mass> for Impulse

type Output = Velocity

The resulting type after applying the / operator.

fn div(self, rhs: Mass) -> Velocity

Performs the / operation.

impl Div<Mass> for Momentum

type Output = Velocity

The resulting type after applying the / operator.

fn div(self, rhs: Mass) -> Velocity

Performs the / operation.

impl Div<Time> for Mass

type Output = MassFlowRate

The resulting type after applying the / operator.

fn div(self, rhs: Time) -> MassFlowRate

Performs the / operation.

impl Div<Volume> for Mass

type Output = Density

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<f64> for Mass

type Output = Mass

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div for Mass

type Output = f64

The resulting type after applying the / operator.

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

Performs the / operation.

impl DivAssign<f64> for Mass

fn div_assign(&mut self, rhs: f64)

Performs the /= operation.

impl Mul<Acceleration> for Mass

type Output = Force

The resulting type after applying the * operator.

fn mul(self, rhs: Acceleration) -> Force

Performs the * operation.

impl Mul<Mass> for Acceleration

type Output = Force

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Mass> for Velocity

type Output = Momentum

The resulting type after applying the * operator.

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

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

type Output = Momentum

The resulting type after applying the * operator.

fn mul(self, rhs: Velocity) -> Momentum

Performs the * operation.

impl Mul<f64> for Mass

type Output = Mass

The resulting type after applying the * operator.

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

Performs the * operation.

impl MulAssign<f64> for Mass

fn mul_assign(&mut self, rhs: f64)

Performs the *= operation.

impl Neg for Mass

type Output = Mass

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl PartialEq for Mass

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Mass

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

type Output = Mass

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign for Mass

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl Sum for Mass

fn sum<I: Iterator<Item = Self>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by “summing up” the items.

impl Copy for Mass

impl StructuralPartialEq for Mass