// The MIT License (MIT) // // Copyright (c) 2018 Mateusz Pusz // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in all // copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE // SOFTWARE. #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include // the below is not used in this header but should be exposed with it #include #include namespace mp_units { namespace detail { template concept QuantityOne = QuantityOf; template using quantity_like_type = quantity::reference, typename quantity_like_traits::rep>; template concept RepSafeConstructibleFrom = // exposition only std::constructible_from && (treat_as_floating_point || !treat_as_floating_point); // QFrom ratio is an exact multiple of QTo template concept Harmonic = // exposition only Quantity && Quantity && is_integral(get_canonical_unit(QFrom::unit).mag / get_canonical_unit(QTo::unit).mag); template concept QuantityConvertibleTo = // exposition only Quantity && Quantity && requires(QFrom q) { detail::sudo_cast(q); } && (treat_as_floating_point || (!treat_as_floating_point && Harmonic)); template concept InvokeResultOf = std::regular_invocable && RepresentationOf, Ch>; } // namespace detail /** * @brief A quantity * * Property of a phenomenon, body, or substance, where the property has a magnitude that can be * expressed by means of a number and a reference. * * @tparam R a reference of the quantity providing all information about quantity properties * @tparam Rep a type to be used to represent values of a quantity */ template Rep = double> class quantity { public: Rep number_; // needs to be public for a structural type // member types and values static constexpr Reference auto reference = R; static constexpr QuantitySpec auto quantity_spec = get_quantity_spec(reference); static constexpr Dimension auto dimension = quantity_spec.dimension; static constexpr Unit auto unit = get_unit(reference); using rep = Rep; // static member functions [[nodiscard]] static constexpr quantity zero() noexcept requires requires { quantity_values::zero(); } { return quantity(quantity_values::zero()); } [[nodiscard]] static constexpr quantity one() noexcept requires requires { quantity_values::one(); } { return quantity(quantity_values::one()); } [[nodiscard]] static constexpr quantity min() noexcept requires requires { quantity_values::min(); } { return quantity(quantity_values::min()); } [[nodiscard]] static constexpr quantity max() noexcept requires requires { quantity_values::max(); } { return quantity(quantity_values::max()); } // construction, assignment, destruction quantity() = default; quantity(const quantity&) = default; quantity(quantity&&) = default; template requires detail::RepSafeConstructibleFrom constexpr explicit(!detail::QuantityOne) quantity(Value&& v) : number_(std::forward(v)) { } template Q> constexpr explicit(false) quantity(const Q& q) : number_(detail::sudo_cast(q).number()) { } template requires detail::QuantityConvertibleTo, quantity> constexpr explicit quantity(const Q& q) : quantity(detail::quantity_like_type(quantity_like_traits::number(q))) { } quantity& operator=(const quantity&) = default; quantity& operator=(quantity&&) = default; // data access [[nodiscard]] constexpr const rep& number() const& noexcept { return number_; } [[nodiscard]] constexpr rep&& number() && noexcept { return std::move(number_); } [[nodiscard]] constexpr const rep&& number() const&& noexcept { return std::move(number_); } template requires requires(quantity q) { q[U{}]; } [[nodiscard]] constexpr rep number_in(U) const noexcept { return (*this)[U{}].number(); } template requires detail::QuantityConvertibleTo{}, Rep>> [[nodiscard]] constexpr quantity<::mp_units::reference{}, Rep> operator[](U) const { return quantity<::mp_units::reference{}, Rep>{*this}; } // member unary operators [[nodiscard]] constexpr Quantity auto operator+() const requires requires(rep v) { { +v } -> std::common_with; } { using ret = quantity; return ret(+number()); } [[nodiscard]] constexpr Quantity auto operator-() const requires std::regular_invocable, rep> { using ret = quantity; return ret(-number()); } constexpr quantity& operator++() requires requires(rep v) { { ++v } -> std::same_as; } { ++number_; return *this; } [[nodiscard]] constexpr quantity operator++(int) requires requires(rep v) { { v++ } -> std::same_as; } { return quantity(number_++); } constexpr quantity& operator--() requires requires(rep v) { { --v } -> std::same_as; } { --number_; return *this; } [[nodiscard]] constexpr quantity operator--(int) requires requires(rep v) { { v-- } -> std::same_as; } { return quantity(number_--); } constexpr quantity& operator+=(const quantity& q) requires requires(rep a, rep b) { { a += b } -> std::same_as; } { number_ += q.number(); return *this; } constexpr quantity& operator-=(const quantity& q) requires requires(rep a, rep b) { { a -= b } -> std::same_as; } { number_ -= q.number(); return *this; } template constexpr quantity& operator*=(const Rep2& rhs) requires requires(rep a, const Rep2 b) { { a *= b } -> std::same_as; } { number_ *= rhs; return *this; } template constexpr quantity& operator*=(const Q& rhs) requires requires(rep a, const typename Q::rep b) { { a *= b } -> std::same_as; } { number_ *= rhs.number(); return *this; } template constexpr quantity& operator/=(const Rep2& rhs) requires requires(rep a, const Rep2 b) { { a /= b } -> std::same_as; } { gsl_ExpectsAudit(rhs != quantity_values::zero()); number_ /= rhs; return *this; } template constexpr quantity& operator/=(const Q& rhs) requires requires(rep a, const typename Q::rep b) { { a /= b } -> std::same_as; } { gsl_ExpectsAudit(rhs.number() != quantity_values::zero()); number_ /= rhs.number(); return *this; } template constexpr quantity& operator%=(const Rep2& rhs) requires(!treat_as_floating_point) && (!treat_as_floating_point) && requires(rep a, const Rep2 b) { { a %= b } -> std::same_as; } { gsl_ExpectsAudit(rhs != quantity_values::zero()); number_ %= rhs; return *this; } template constexpr quantity& operator%=(const Q& rhs) requires(!treat_as_floating_point) && (!treat_as_floating_point) && requires(rep a, const typename Q::rep b) { { a %= b } -> std::same_as; } { gsl_ExpectsAudit(rhs.number() != quantity_values::zero()); number_ %= rhs.number(); return *this; } constexpr quantity& operator%=(const quantity& q) requires(!treat_as_floating_point) && requires(rep a, rep b) { { a %= b } -> std::same_as; } { gsl_ExpectsAudit(q.number() != quantity_values::zero()); number_ %= q.number(); return *this; } // Hidden Friends // Below friend functions are to be found via argument-dependent lookup only template [[nodiscard]] friend constexpr Quantity auto operator+(const quantity& lhs, const Value& rhs) requires requires { // TODO: Simplify when Clang catches up. requires !Quantity; requires unit == ::mp_units::one; requires detail::InvokeResultOf, rep, Value>; } { return ::mp_units::quantity(lhs.number() + rhs); } template [[nodiscard]] friend constexpr Quantity auto operator+(const Value& lhs, const quantity& rhs) requires requires { // TODO: Simplify when Clang catches up. requires !Quantity; requires unit == ::mp_units::one; requires detail::InvokeResultOf, Value, rep>; } { return ::mp_units::quantity(lhs + rhs.number()); } template [[nodiscard]] friend constexpr Quantity auto operator-(const quantity& lhs, const Value& rhs) requires requires { // TODO: Simplify when Clang catches up. requires !Quantity; requires unit == ::mp_units::one; requires detail::InvokeResultOf, rep, Value>; } { return ::mp_units::quantity(lhs.number() - rhs); } template [[nodiscard]] friend constexpr Quantity auto operator-(const Value& lhs, const quantity& rhs) requires requires { // TODO: Simplify when Clang catches up. requires !Quantity; requires unit == ::mp_units::one; requires detail::InvokeResultOf, Value, rep>; } { return ::mp_units::quantity(lhs - rhs.number()); } template requires detail::InvokeResultOf, rep, const Value&> [[nodiscard]] friend constexpr Quantity auto operator*(const quantity& q, const Value& v) { using ret = quantity, rep, Value>>; return ret(q.number() * v); } template requires detail::InvokeResultOf, const Value&, rep> [[nodiscard]] friend constexpr Quantity auto operator*(const Value& v, const quantity& q) { using ret = quantity, Value, rep>>; return ret(v * q.number()); } template requires(!Quantity) && detail::InvokeResultOf, rep, const Value&> [[nodiscard]] friend constexpr Quantity auto operator/(const quantity& q, const Value& v) { gsl_ExpectsAudit(v != quantity_values::zero()); using ret = quantity, rep, Value>>; return ret(q.number() / v); } template requires(!Quantity) && detail::InvokeResultOf, const Value&, rep> [[nodiscard]] friend constexpr Quantity auto operator/(const Value& v, const quantity& q) { return (dimensionless[::mp_units::one] / reference)(v / q.number()); } template requires(!Quantity) && (!treat_as_floating_point) && (!treat_as_floating_point) && detail::InvokeResultOf, rep, const Value&> [[nodiscard]] friend constexpr Quantity auto operator%(const quantity& q, const Value& v) { gsl_ExpectsAudit(v != quantity_values::zero()); using ret = quantity, rep, Value>>; return ret(q.number() % v); } [[nodiscard]] friend constexpr Quantity auto operator%(const quantity& lhs, const quantity& rhs) requires(!treat_as_floating_point) && detail::InvokeResultOf, rep, rep> { gsl_ExpectsAudit(rhs.number() != quantity_values::zero()); using ret = quantity, rep, rep>>; return ret(lhs.number() % rhs.number()); } [[nodiscard]] friend constexpr auto operator<=>(const quantity& lhs, const quantity& rhs) requires std::three_way_comparable #if __cpp_impl_three_way_comparison = default; #else { return lhs.number() <=> rhs.number(); } #endif [[nodiscard]] friend constexpr bool operator==(const quantity& lhs, const quantity& rhs) = default; }; // CTAD template explicit(false) quantity(quantity) -> quantity; template Rep> explicit(false) quantity(Rep) -> quantity; #if !UNITS_COMP_CLANG || UNITS_COMP_CLANG > 16 template Rep> explicit(false) quantity(Rep&&) -> quantity; #endif template explicit quantity(Q) -> quantity::reference, typename quantity_like_traits::rep>; // non-member binary operators template requires(get_kind(Q1::quantity_spec) == get_kind(Q2::quantity_spec)) && detail::InvokeResultOf, typename Q1::rep, typename Q2::rep> [[nodiscard]] constexpr Quantity auto operator+(const Q1& lhs, const Q2& rhs) { constexpr auto ref = common_reference(Q1::reference, Q2::reference); using ret = quantity; return ret(ret(lhs).number() + ret(rhs).number()); } template requires(get_kind(Q1::quantity_spec) == get_kind(Q2::quantity_spec)) && detail::InvokeResultOf, typename Q1::rep, typename Q2::rep> [[nodiscard]] constexpr Quantity auto operator-(const Q1& lhs, const Q2& rhs) { constexpr auto ref = common_reference(Q1::reference, Q2::reference); using ret = quantity; return ret(ret(lhs).number() - ret(rhs).number()); } template requires detail::InvokeResultOf<(Q1::quantity_spec * Q2::quantity_spec).character, std::multiplies<>, typename Q1::rep, typename Q2::rep> [[nodiscard]] constexpr Quantity auto operator*(const Q1& lhs, const Q2& rhs) { return lhs.number() * rhs.number() * (Q1::reference * Q2::reference); } template requires detail::InvokeResultOf<(Q1::quantity_spec / Q2::quantity_spec).character, std::divides<>, typename Q1::rep, typename Q2::rep> [[nodiscard]] constexpr Quantity auto operator/(const Q1& lhs, const Q2& rhs) { gsl_ExpectsAudit(rhs.number() != quantity_values::zero()); return lhs.number() / rhs.number() * (Q1::reference / Q2::reference); } template requires(!treat_as_floating_point) && (!treat_as_floating_point) && (interconvertible(Q1::reference, Q2::reference) || QuantityOf) && detail::InvokeResultOf, typename Q1::rep, typename Q2::rep> [[nodiscard]] constexpr Quantity auto operator%(const Q1& lhs, const Q2& rhs) { gsl_ExpectsAudit(rhs.number() != quantity_values::zero()); using ret = quantity, typename Q1::rep, typename Q2::rep>>; return ret(lhs.number() % rhs.number()); } template requires(get_kind(Q1::quantity_spec) == get_kind(Q2::quantity_spec)) && std::three_way_comparable_with [[nodiscard]] constexpr auto operator<=>(const Q1& lhs, const Q2& rhs) { constexpr auto ref = common_reference(Q1::reference, Q2::reference); return quantity(lhs).number() <=> quantity(rhs).number(); } template requires(get_kind(Q1::quantity_spec) == get_kind(Q2::quantity_spec)) && std::equality_comparable_with [[nodiscard]] constexpr bool operator==(const Q1& lhs, const Q2& rhs) { constexpr auto ref = common_reference(Q1::reference, Q2::reference); return quantity(lhs).number() == quantity(rhs).number(); } } // namespace mp_units namespace std { template requires requires { { mp_units::common_reference(Q1::reference, Q2::reference) } -> mp_units::Reference; typename common_type_t; } struct common_type { public: using type = mp_units::quantity>; }; } // namespace std