forked from mpusz/mp-units
90 lines
3.3 KiB
Markdown
90 lines
3.3 KiB
Markdown
[](./LICENSE.md)
|
|
[](https://travis-ci.com/mpusz/units)
|
|
[](https://bintray.com/mpusz/conan-mpusz/mp-units%3Ampusz/0.6.0%3Astable/link)
|
|
[](https://bintray.com/mpusz/conan-mpusz/mp-units%3Ampusz/_latestVersion)
|
|
|
|
# `mp-units` - A Units Library for C++
|
|
|
|
**The mp-units library is the subject of this ISO C++ paper: [P1935](https://wg21.link/p1935).
|
|
It is explained in this [CppCon 2019 talk](https://youtu.be/0YW6yxkdhlU) (slightly dated now).
|
|
We are working towards potentially having it standardized for C++23 and are actively looking
|
|
for parties interested in field trialing the library.**
|
|
|
|
|
|
## Documentation
|
|
|
|
An extensive project documentation including installation instructions and user's
|
|
guide can be found on [mp-units GitHub Pages](https://mpusz.github.io/units).
|
|
|
|
|
|
## TL;DR
|
|
|
|
`mp-units` is a compile-time enabled Modern C++ library that provides compile-time dimensional
|
|
analysis and unit/quantity manipulation. The basic idea and design heavily bases on
|
|
`std::chrono::duration` and extends it to work properly with many dimensions.
|
|
|
|
Here is a small example of possible operations:
|
|
|
|
```cpp
|
|
#include <units/physical/si/derived/area.h>
|
|
#include <units/physical/si/derived/frequency.h>
|
|
#include <units/physical/si/derived/speed.h>
|
|
|
|
using namespace units::physical::si;
|
|
|
|
// simple numeric operations
|
|
static_assert(10_q_km / 2 == 5_q_km);
|
|
|
|
// unit conversions
|
|
static_assert(1_q_h == 3600_q_s);
|
|
static_assert(1_q_km + 1_q_m == 1001_q_m);
|
|
|
|
// dimension conversions
|
|
static_assert(1_q_km / 1_q_s == 1000_q_m_per_s);
|
|
static_assert(2_q_km_per_h * 2_q_h == 4_q_km);
|
|
static_assert(2_q_km / 2_q_km_per_h == 1_q_h);
|
|
|
|
static_assert(2_q_m * 3_q_m == 6_q_m2);
|
|
|
|
static_assert(10_q_km / 5_q_km == 2);
|
|
|
|
static_assert(1000 / 1_q_s == 1_q_kHz);
|
|
```
|
|
|
|
_Try it on the [Compiler Explorer](https://godbolt.org/z/YWch6d)._
|
|
|
|
This library requires some C++20 features (concepts, classes as NTTPs, ...). Thanks to
|
|
them the user gets a powerful but still easy to use interface and all unit conversions
|
|
and dimensional analysis can be performed without sacrificing on accuracy. Please see
|
|
the below example for a quick preview of basic library features:
|
|
|
|
```cpp
|
|
#include <units/physical/si/derived/speed.h>
|
|
#include <units/physical/si/international/derived/speed.h>
|
|
#include <units/format.h>
|
|
#include <iostream>
|
|
|
|
using namespace units::physical;
|
|
|
|
constexpr Speed auto avg_speed(Length auto d, Time auto t)
|
|
{
|
|
return d / t;
|
|
}
|
|
|
|
int main()
|
|
{
|
|
using namespace units::physical::si::literals;
|
|
Speed auto v1 = avg_speed(220_q_km, 2_q_h);
|
|
Speed auto v2 = avg_speed(si::length<si::international::mile>(140), si::time<si::hour>(2));
|
|
Speed auto v3 = quantity_cast<si::metre_per_second>(v2);
|
|
Speed auto v4 = quantity_cast<int>(v3);
|
|
|
|
std::cout << v1 << '\n'; // 110 km/h
|
|
std::cout << v2 << '\n'; // 70 mi/h
|
|
std::cout << v3 << '\n'; // 31.2928 m/s
|
|
std::cout << v4 << '\n'; // 31 m/s
|
|
}
|
|
```
|
|
|
|
_Try it on the [Compiler Explorer](https://godbolt.org/z/8dh4cv)._
|