Struct Dimension 

pub struct Dimension(pub [i8; 7]);

A dimensional exponent vector over the seven UCUM base quantities.

The exponent order is fixed and documented:

index	quantity	base unit
0	length	m
1	time	s
2	mass	g
3	plane angle	rad
4	temperature	K
5	electric charge	C
6	luminous intensity	cd

All arithmetic saturates at the i8 bounds rather than overflowing, so the type can never panic, even on absurd inputs such as m120.m120.

use ucum::Dimension;
let area = Dimension::DIMENSIONLESS.mul(Dimension([2, 0, 0, 0, 0, 0, 0]));
assert_eq!(area, Dimension([2, 0, 0, 0, 0, 0, 0]));

Tuple Fields

0: [i8; 7]

Implementations

impl Dimension

pub const DIMENSIONLESS: Dimension

The dimensionless dimension (all exponents zero).

pub fn is_dimensionless(&self) -> bool

Returns true when every exponent is zero.

pub fn mul(self, other: Dimension) -> Dimension

Multiplies two dimensions by adding their exponents (saturating).

Named mul per the public UCUM API contract; it intentionally does not implement std::ops::Mul, to keep the type’s surface explicit.

pub fn inv(self) -> Dimension

Inverts a dimension by negating its exponents (saturating).

pub fn powi(self, n: i8) -> Dimension

Raises a dimension to an integer power (saturating).

Trait Implementations

impl Clone for Dimension

fn clone(&self) -> Dimension

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Dimension

impl Debug for Dimension

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

Formats the value using the given formatter.

impl Display for Dimension

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

Renders a dimension in UCUM base-unit syntax, e.g. m3.s-1.

The dimensionless dimension renders as 1.

impl Eq for Dimension

impl Hash for Dimension

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Dimension

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