WPILibC++ 2023.4.3
length.h
Go to the documentation of this file.
1// Copyright (c) FIRST and other WPILib contributors.
2// Open Source Software; you can modify and/or share it under the terms of
3// the WPILib BSD license file in the root directory of this project.
4
5// Copyright (c) 2016 Nic Holthaus
6//
7// The MIT License (MIT)
8//
9// Permission is hereby granted, free of charge, to any person obtaining a copy
10// of this software and associated documentation files (the "Software"), to deal
11// in the Software without restriction, including without limitation the rights
12// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13// copies of the Software, and to permit persons to whom the Software is
14// furnished to do so, subject to the following conditions:
15//
16// The above copyright notice and this permission notice shall be included in
17// all copies or substantial portions of the Software.
18//
19// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
25// SOFTWARE.
26
27#pragma once
28
29#include "units/base.h"
30
31namespace units {
32/**
33 * @namespace units::length
34 * @brief namespace for unit types and containers representing length values
35 * @details The SI unit for length is `meters`, and the corresponding
36 * `base_unit` category is `length_unit`.
37 * @anchor lengthContainers
38 * @sa See unit_t for more information on unit type containers.
39 */
40#if !defined(DISABLE_PREDEFINED_UNITS) || \
41 defined(ENABLE_PREDEFINED_LENGTH_UNITS)
42UNIT_ADD_WITH_METRIC_PREFIXES(length, meter, meters, m,
43 unit<std::ratio<1>, units::category::length_unit>)
44UNIT_ADD(length, foot, feet, ft, unit<std::ratio<381, 1250>, meters>)
45UNIT_ADD(length, mil, mils, mil, unit<std::ratio<1000>, feet>)
46UNIT_ADD(length, inch, inches, in, unit<std::ratio<1, 12>, feet>)
47UNIT_ADD(length, mile, miles, mi, unit<std::ratio<5280>, feet>)
49 unit<std::ratio<1852>, meters>)
50UNIT_ADD(length, astronicalUnit, astronicalUnits, au,
51 unit<std::ratio<149597870700>, meters>)
53 unit<std::ratio<9460730472580800>, meters>)
54UNIT_ADD(length, parsec, parsecs, pc,
55 unit<std::ratio<648000>, astronicalUnits, std::ratio<-1>>)
57 unit<std::ratio<1, 10>, nanometers>)
58UNIT_ADD(length, cubit, cubits, cbt, unit<std::ratio<18>, inches>)
59UNIT_ADD(length, fathom, fathoms, ftm, unit<std::ratio<6>, feet>)
60UNIT_ADD(length, chain, chains, ch, unit<std::ratio<66>, feet>)
61UNIT_ADD(length, furlong, furlongs, fur, unit<std::ratio<10>, chains>)
62UNIT_ADD(length, hand, hands, hand, unit<std::ratio<4>, inches>)
63UNIT_ADD(length, league, leagues, lea, unit<std::ratio<3>, miles>)
64UNIT_ADD(length, nauticalLeague, nauticalLeagues, nl,
65 unit<std::ratio<3>, nauticalMiles>)
66UNIT_ADD(length, yard, yards, yd, unit<std::ratio<3>, feet>)
67
69#endif
70
71using namespace length;
72} // namespace units
#define UNIT_ADD_CATEGORY_TRAIT(unitCategory)
Macro to create the is_category_unit type trait.
Definition: base.h:381
Definition: StdDeque.h:50
Unit Conversion Library namespace.
Definition: current.h:31
unit< std::ratio< 1852 >, meters > lightyears
Definition: length.h:52
unit< std::ratio< 1852 >, meters > lightyear
Definition: length.h:52
unit< std::ratio< 1852 >, meters > unit< std::ratio< 9460730472580800 >, meters > angstrom
Definition: length.h:56
UNIT_ADD(area, square_meter, square_meters, sq_m, unit< std::ratio< 1 >, units::category::area_unit >) UNIT_ADD(area
unit< std::ratio< 1852 >, meters > ly
Definition: length.h:52
nmi
Definition: length.h:48
nauticalMile
Definition: length.h:48
nauticalMiles
Definition: length.h:48
unit< std::ratio< 1852 >, meters > unit< std::ratio< 9460730472580800 >, meters > angstroms
Definition: length.h:56
UNIT_ADD_WITH_METRIC_PREFIXES(current, ampere, amperes, A, unit< std::ratio< 1 >, units::category::current_unit >) using namespace current
Class representing SI base unit types.
Definition: base.h:758
Type representing an arbitrary unit.
Definition: base.h:884