Struct measurements::density::Density

pub struct Density { /* private fields */ }

The Density struct can be used to deal with Densities in a common way, to enable mass, volume and density calculations and unit conversions.

Example1 - calculating volume from units of mass and density

extern crate measurements;
use measurements::{Density, Mass, Volume};

fn main() {
   // Q: A 12 stone man hops into a brimming full bath, completely emersing himself.
   // How many gallons of water spill on the floor?
   // (Assume The human body is roughly about as dense as water - 1 gm/cm³)
   //
   let body_density: Density = Mass::from_grams(1.0) / Volume:: from_cubic_centimetres(1.0);
   let mans_weight = Mass::from_stones(12.0);
   let water_volume = mans_weight / body_density;
   println!("{} gallons of water spilled on the floor", water_volume.as_gallons());
}

Example2 - converting to ad-hoc units of density

extern crate measurements;
use measurements::{Density, Mass, Volume};

fn main() {
   // Q: what is 3 grams per litre in units of ounces per quart?
   //
   let density: Density = Mass::from_grams(3.0) / Volume:: from_litres(1.0);
   let ounces = (density * Volume::from_quarts(1.0)).as_ounces();
   println!("Answer is {} ounces per quart", ounces);
}

Implementations

impl Density

pub fn from_kilograms_per_cubic_meter(kilograms_per_cubic_meter: f64) -> Density

Create a new Density from a floating point value in kilograms per cubic meter

pub fn from_pounds_per_cubic_feet(pounds_per_cubic_foot: f64) -> Density

Create a new Density from a floating point value in pounds per cubic feet

pub fn as_kilograms_per_cubic_meter(&self) -> f64

Convert this Density to a value in kilograms per cubic meter

pub fn as_pounds_per_cubic_feet(&self) -> f64

Convert this Density to a value in pounds per cubic feet

Trait Implementations

impl Add<Density> for Density

type Output = Self

The resulting type after applying the + operator.

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

Performs the + operation.

impl Clone for Density

fn clone(&self) -> Density

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Density

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

Formats the value using the given formatter.

impl Display for Density

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<Density> for Density

type Output = f64

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<f64> for Density

type Output = Self

The resulting type after applying the / operator.

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

Performs the / operation.

impl Measurement for Density

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<Density> for Volume

type Output = Mass

The resulting type after applying the * operator.

fn mul(self, other: Density) -> Mass

Performs the * operation.

impl Mul<Density> for f64

type Output = Density

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Volume> for Density

type Output = Mass

The resulting type after applying the * operator.

fn mul(self, other: Volume) -> Mass

Performs the * operation.

impl Mul<f64> for Density

type Output = Self

The resulting type after applying the * operator.

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

Performs the * operation.

impl PartialEq<Density> for Density

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<Density> for Density

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<Density> for Density

type Output = Self

The resulting type after applying the - operator.

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

Performs the - operation.

impl Copy for Density

impl Eq for Density