Struct Force 

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

A force quantity, stored canonically in Newtons (N).

Construction

use space_units::prelude::*;

let f = Force::from_kn(50.0);
let f2 = 50.0.kn();            // NumericExt shorthand

Supported units

Constructor	Accessor	Unit
from_n	in_n	Newton (N)
from_kn	in_kn	kilonewton (kN)
from_mn	in_mn	meganewton (MN)
from_lbf	in_lbf	pound-force (lbf)
from_dyn	in_dyn	dyne (dyn)

Typed arithmetic

• Force × Length → Energy
• Force × Time → Impulse
• Force / Mass → Acceleration
• Force / Acceleration → Mass
• Force / Area → Pressure
• Force / MassFlowRate → Velocity
• Force / Velocity → MassFlowRate
• Energy / Length → Force

Implementations

impl Force

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

Create from Newtons (canonical unit).

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

Create from kilonewtons. 1 kN = 1 000 N.

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

Create from meganewtons. 1 MN = 1 000 000 N.

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

Create from pound-force. 1 lbf = 4.448 222 N.

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

Create from dynes. 1 dyn = 1e-5 N.

pub const fn in_n(self) -> f64

Get value in Newtons.

pub const fn in_kn(self) -> f64

Get value in kilonewtons.

pub const fn in_mn(self) -> f64

Get value in meganewtons.

pub const fn in_lbf(self) -> f64

Get value in pound-force.

pub const fn in_dyn(self) -> f64

Get value in dynes.

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

Get value in the specified ForceUnit.

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

Return a DisplayWithUnit for formatted printing in the given unit.

pub fn abs(self) -> Self

Absolute value.

Trait Implementations

impl Add for Force

type Output = Force

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign for Force

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Clone for Force

fn clone(&self) -> Force

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Force

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

Formats the value using the given formatter.

impl Default for Force

fn default() -> Force

Returns the “default value” for a type.

impl Display for Force

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

Formats the value using the given formatter.

impl Div<Acceleration> for Force

type Output = Mass

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<Area> for Force

type Output = Pressure

The resulting type after applying the / operator.

fn div(self, rhs: Area) -> Pressure

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<MassFlowRate> for Force

type Output = Velocity

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<Velocity> for Force

type Output = MassFlowRate

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<f64> for Force

type Output = Force

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div for Force

type Output = f64

The resulting type after applying the / operator.

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

Performs the / operation.

impl DivAssign<f64> for Force

fn div_assign(&mut self, rhs: f64)

Performs the /= operation.

impl Mul<Force> for Length

type Output = Energy

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Force> for Time

type Output = Impulse

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Force> for f64

type Output = Force

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Length> for Force

type Output = Energy

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Time> for Force

type Output = Impulse

The resulting type after applying the * operator.

fn mul(self, rhs: Time) -> Impulse

Performs the * operation.

impl Mul<f64> for Force

type Output = Force

The resulting type after applying the * operator.

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

Performs the * operation.

impl MulAssign<f64> for Force

fn mul_assign(&mut self, rhs: f64)

Performs the *= operation.

impl Neg for Force

type Output = Force

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl PartialEq for Force

fn eq(&self, other: &Force) -> 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 Force

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

type Output = Force

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign for Force

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl Sum for Force

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 Force

impl StructuralPartialEq for Force