uom/si/
area.rs

1//! Area (base unit square meter, m²).
2
3quantity! {
4    /// Area (base unit square meter, m²).
5    quantity: Area; "area";
6    /// Dimension of area, L² (base unit square meter, m²).
7    dimension: ISQ<
8        P2,     // length
9        Z0,     // mass
10        Z0,     // time
11        Z0,     // electric current
12        Z0,     // thermodynamic temperature
13        Z0,     // amount of substance
14        Z0>;    // luminous intensity
15    units {
16        @square_yottameter: prefix!(yotta) * prefix!(yotta);
17            "Ym²", "square yottameter", "square yottameters";
18        @square_zettameter: prefix!(zetta) * prefix!(zetta);
19            "Zm²", "square zettameter", "square zettameters";
20        @square_exameter: prefix!(exa) * prefix!(exa);
21            "Em²", "square exameter", "square exameters";
22        @square_petameter: prefix!(peta) * prefix!(peta);
23            "Pm²", "square petameter", "square petameters";
24        @square_terameter: prefix!(tera) * prefix!(tera);
25            "Tm²", "square terameter", "square terameters";
26        @square_gigameter: prefix!(giga) * prefix!(giga);
27            "Gm²", "square gigameter", "square gigameters";
28        @square_megameter: prefix!(mega) * prefix!(mega);
29            "Mm²", "square megameter", "square megameters";
30        @square_kilometer: prefix!(kilo) * prefix!(kilo);
31            "km²", "square kilometer", "square kilometers";
32        @square_hectometer: prefix!(hecto) * prefix!(hecto);
33            "hm²", "square hectometer", "square hectometers";
34        @square_decameter: prefix!(deca) * prefix!(deca);
35            "dam²", "square decameter", "square decameters";
36        @square_meter: prefix!(none);
37            "m²", "square meter", "square meters";
38        @square_decimeter: prefix!(deci) * prefix!(deci);
39            "dm²", "square decimeter", "square decimeters";
40        @square_centimeter: prefix!(centi) * prefix!(centi);
41            "cm²", "square centimeter", "square centimeters";
42        @square_millimeter: prefix!(milli) * prefix!(milli);
43            "mm²", "square millimeter", "square millimeters";
44        @square_micrometer: prefix!(micro) * prefix!(micro);
45            "µm²", "square micrometer", "square micrometers";
46        @square_nanometer: prefix!(nano) * prefix!(nano);
47            "nm²", "square nanometer", "square nanometers";
48        @square_picometer: prefix!(pico) * prefix!(pico);
49            "pm²", "square picometer", "square picometers";
50        @square_femtometer: prefix!(femto) * prefix!(femto);
51            "fm²", "square femtometer", "square femtometers";
52        @square_attometer: prefix!(atto) * prefix!(atto);
53            "am²", "square attometer", "square attometers";
54        @square_zeptometer: prefix!(zepto) * prefix!(zepto);
55            "zm²", "square zeptometer", "square zeptometers";
56        @square_yoctometer: prefix!(yocto) * prefix!(yocto);
57            "ym²", "square yoctometer", "square yoctometers";
58
59        @acre: 4.046_873_E3; "ac", "acre", "acres";
60        @are: 1.0_E2; "a", "are", "ares";
61        @barn: 1.0_E-28; "b", "barn", "barns";
62        @circular_mil: 5.067_075_E-10; "cmil", "circular mil", "circular mils";
63        @hectare: 1.0_E4; "ha", "hectare", "hectares";
64        @square_foot: 9.290_304_E-2; "ft²", "square foot", "square feet";
65        @square_inch: 6.451_6_E-4; "in²", "square inch", "square inches";
66        @square_mile: 2.589_988_E6; "mi²", "square mile", "square miles";
67        @square_yard: 8.361_274_E-1; "yd²", "square yard", "square yards";
68    }
69}
70
71#[cfg(test)]
72mod tests {
73    storage_types! {
74        use crate::num::One;
75        use crate::si::area as a;
76        use crate::si::length as l;
77        use crate::si::quantities::*;
78        use crate::tests::Test;
79
80        #[test]
81        fn check_dimension() {
82            let _: Area<V> = Length::new::<l::meter>(V::one()) * Length::new::<l::meter>(V::one());
83        }
84
85        #[test]
86        // #392: Disable tests on ARM until issues with floating point behavior can be resolved.
87        #[cfg(not(target_arch = "arm"))]
88        fn check_units() {
89            test::<l::yottameter, a::square_yottameter>();
90            test::<l::zettameter, a::square_zettameter>();
91            test::<l::exameter, a::square_exameter>();
92            test::<l::petameter, a::square_petameter>();
93            test::<l::terameter, a::square_terameter>();
94            test::<l::gigameter, a::square_gigameter>();
95            test::<l::megameter, a::square_megameter>();
96            test::<l::kilometer, a::square_kilometer>();
97            test::<l::hectometer, a::square_hectometer>();
98            test::<l::decameter, a::square_decameter>();
99            test::<l::meter, a::square_meter>();
100            test::<l::decimeter, a::square_decimeter>();
101            test::<l::centimeter, a::square_centimeter>();
102            test::<l::millimeter, a::square_millimeter>();
103            test::<l::micrometer, a::square_micrometer>();
104            test::<l::nanometer, a::square_nanometer>();
105            test::<l::picometer, a::square_picometer>();
106            test::<l::femtometer, a::square_femtometer>();
107            test::<l::attometer, a::square_attometer>();
108            test::<l::zeptometer, a::square_zeptometer>();
109            test::<l::yoctometer, a::square_yoctometer>();
110
111            fn test<L: l::Conversion<V>, A: a::Conversion<V>>() {
112                if A::is_valid() {
113                    Test::assert_eq(&Area::new::<A>(V::one()),
114                        &(Length::new::<L>(V::one()) * Length::new::<L>(V::one())));
115                }            }
116        }
117    }
118}