Struct measurements::length::Length

pub struct Length { /* fields omitted */ }

The Length struct can be used to deal with lengths in a common way. Common metric and imperial units are supported.

Example

use measurements::Length;

let football_field = Length::from_yards(100.0);
let meters = football_field.as_meters();
println!("There are {} meters in a football field.", meters);

Methods

impl Length

pub fn from_meters(meters: f64) -> Self

Create a new Length from a floating point value in meters

pub fn from_metres(metres: f64) -> Self

Create a new Length from a floating point value in metres.

pub fn from_nanometers(nanometers: f64) -> Self

Create a new Length from a floating point value in nanometers.

pub fn from_nanometres(nanometers: f64) -> Self

Create a new Length from a floating point value in nanometres.

pub fn from_micrometers(micrometers: f64) -> Self

Create a new Length from a floating point value in micrometers.

pub fn from_micrometres(micrometers: f64) -> Self

Create a new Length from a floating point value in micrometres.

pub fn from_millimeters(millimeters: f64) -> Self

Create a new Length from a floating point value in millimeters.

pub fn from_millimetres(millimeters: f64) -> Self

Create a new Length from a floating point value in millimetres.

pub fn from_centimeters(centimeters: f64) -> Self

Create a new Length from a floating point value in centimeters.

pub fn from_centimetres(centimeters: f64) -> Self

Create a new Length from a floating point value in centimetres.

pub fn from_decimeters(decimeters: f64) -> Self

Create a new Length from a floating point value in decimeters.

pub fn from_decimetres(decimeters: f64) -> Self

Create a new Length from a floating point value in decimetres.

pub fn from_hectometers(hectometers: f64) -> Self

Create a new Length from a floating point value in hectometers.

pub fn from_hectometres(hectometers: f64) -> Self

Create a new Length from a floating point value in hectometres.

pub fn from_kilometers(kilometers: f64) -> Self

Create a new Length from a floating point value in kilometers.

pub fn from_kilometres(kilometers: f64) -> Self

Create a new Length from a floating point value in kilometres.

pub fn from_inches(inches: f64) -> Self

Create a new Length from a floating point value in inches.

pub fn from_feet(feet: f64) -> Self

Create a new Length from a floating point value in feet.

pub fn from_yards(yards: f64) -> Self

Create a new Length from a floating point value in yards.

pub fn from_furlongs(furlongs: f64) -> Self

Create a new Length from a floating point value in furlongs.

pub fn from_miles(miles: f64) -> Self

Create a new Length from a floating point value in miles.

pub fn as_nanometers(&self) -> f64

Convert this Length to a floating point value in nanometers

pub fn as_nanometres(&self) -> f64

Convert this Length to a floating point value in nanometres

pub fn as_micrometers(&self) -> f64

Convert this Length to a floating point value in micrometers

pub fn as_micrometres(&self) -> f64

Convert this Length to a floating point value in micrometres

pub fn as_millimeters(&self) -> f64

Convert this Length to a floating point value in millimeters

pub fn as_millimetres(&self) -> f64

Convert this Length to a floating point value in millimetres

pub fn as_centimeters(&self) -> f64

Convert this Length to a floating point value in centimeters

pub fn as_centimetres(&self) -> f64

Convert this Length to a floating point value in centimetres

pub fn as_meters(&self) -> f64

Convert this Length to a floating point value in meters

pub fn as_metres(&self) -> f64

Convert this Length to a floating point value in metres

pub fn as_decimeters(&self) -> f64

Convert this Length to a floating point value in decimeters

pub fn as_decimetres(&self) -> f64

Convert this Length to a floating point value in decimetres

pub fn as_hectometers(&self) -> f64

Convert this Length to a floating point value in hectometers

pub fn as_hectometres(&self) -> f64

Convert this Length to a floating point value in hectometres

pub fn as_kilometers(&self) -> f64

Convert this Length to a floating point value in kilometers

pub fn as_kilometres(&self) -> f64

Convert this Length to a floating point value in kilometres

pub fn as_inches(&self) -> f64

Convert this Length to a floating point value in inches

pub fn as_feet(&self) -> f64

Convert this Length to a floating point value in feet

pub fn as_yards(&self) -> f64

Convert this Length to a floating point value in yards

pub fn as_furlongs(&self) -> f64

Convert this Length to a floating point value in furlongs

pub fn as_miles(&self) -> f64

Convert this Length to a floating point value in miles

Trait Implementations

impl Copy for Length

impl Clone for Length

fn clone(&self) -> Length

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Length

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

Formats the value using the given formatter.

impl Measurement for Length

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 Display for Length

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

Formats the value using the given formatter.

impl Add for Length

type Output = Self

The resulting type after applying the + operator.

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

Performs the + operation.

impl Sub for Length

type Output = Self

The resulting type after applying the - operator.

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

Performs the - operation.

impl Div<Length> for Length

type Output = f64

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<f64> for Length

type Output = Self

The resulting type after applying the / operator.

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

Performs the / operation.

impl Mul<f64> for Length

type Output = Self

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Length> for f64

type Output = Length

The resulting type after applying the * operator.

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

Performs the * operation.

impl Eq for Length

impl PartialEq for Length

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

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 Mul<Length> for Length

type Output = Area

The resulting type after applying the * operator.

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

Performs the * operation.

impl Div<Length> for Area

type Output = Length

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<Speed> for Length

type Output = Duration

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<Duration> for Length

type Output = Speed

The resulting type after applying the / operator.

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

Performs the / operation.

impl Mul<Length> for Area

type Output = Volume

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Area> for Length

type Output = Volume

The resulting type after applying the * operator.

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

Performs the * operation.

impl Div<Length> for Volume

type Output = Area

The resulting type after applying the / operator.

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

Performs the / operation.

impl Mul<Force> for Length

type Output = TorqueEnergy

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Length> for Force

type Output = TorqueEnergy

The resulting type after applying the * operator.

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

Performs the * operation.

impl Div<Length> for TorqueEnergy

type Output = Force

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<Length> for Torque

type Output = Force

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<Length> for Energy

type Output = Force

The resulting type after applying the / operator.

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

Performs the / operation.