// 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 // IWYU pragma: begin_exports #include #include // IWYU pragma: end_exports #include #include #include namespace units { namespace detail { template inline constexpr auto make_quantity_kind_fn = [](auto&& q) { using Q = std::remove_reference_t; return quantity_kind(std::forward(q)); }; template inline constexpr auto& make_quantity_kind = make_quantity_kind_fn; template inline constexpr auto downcasted_kind_fn = [](auto q) { using Q = decltype(q); return make_quantity_kind_fn>(std::move(q)); }; template inline constexpr auto& downcasted_kind = downcasted_kind_fn; } // namespace detail /** * @brief A concept matching two related quantity kinds * * Satisfied by quantity kinds having equivalent base kinds. */ template concept QuantityKindRelatedTo = QuantityKind && QuantityKind && equivalent; /** * @brief A quantity kind * * A quantity with more specific usage as determined by its kind. * See https://jcgm.bipm.org/vim/en/1.2.html and NOTE 1 at https://jcgm.bipm.org/vim/en/1.1.html. * * @tparam K the kind of quantity * @tparam U the measurement unit of the quantity kind * @tparam Rep the type to be used to represent values of the quantity kind */ template U, Representation Rep = double> class quantity_kind { public: using kind_type = K; using quantity_type = quantity; using dimension = typename quantity_type::dimension; using unit = typename quantity_type::unit; using rep = typename quantity_type::rep; private: quantity_type q_; public: quantity_kind() = default; quantity_kind(const quantity_kind&) = default; quantity_kind(quantity_kind&&) = default; template Value> requires is_same_v && std::is_constructible_v constexpr explicit quantity_kind(const Value& v) : q_(v) {} template requires (Quantity || QuantityLike) && std::is_constructible_v constexpr explicit quantity_kind(const Q& q) : q_{q} {} template QK2> requires std::is_convertible_v constexpr explicit(false) quantity_kind(const QK2& qk) : q_{qk.common()} {} quantity_kind& operator=(const quantity_kind&) = default; quantity_kind& operator=(quantity_kind&&) = default; [[nodiscard]] constexpr quantity_type common() const noexcept { return q_; } [[nodiscard]] static constexpr quantity_kind zero() noexcept requires requires { quantity_type::zero(); } { return quantity_kind(quantity_type::zero()); } [[nodiscard]] static constexpr quantity_kind one() noexcept requires requires { quantity_type::one(); } { return quantity_kind(quantity_type::one()); } [[nodiscard]] static constexpr quantity_kind min() noexcept requires requires { quantity_type::min(); } { return quantity_kind(quantity_type::min()); } [[nodiscard]] static constexpr quantity_kind max() noexcept requires requires { quantity_type::max(); } { return quantity_kind(quantity_type::max()); } [[nodiscard]] constexpr quantity_kind operator+() const requires requires(quantity_type q) { +q; } { return *this; } [[nodiscard]] constexpr QuantityKind auto operator-() const requires requires(quantity_type q) { -q; } { return detail::make_quantity_kind(-q_); } constexpr quantity_kind& operator++() requires requires(quantity_type q) { ++q; } { ++q_; return *this; } [[nodiscard]] constexpr quantity_kind operator++(int) requires requires(quantity_type q) { q++; } { return quantity_kind(q_++); } constexpr quantity_kind& operator--() requires requires(quantity_type q) { --q; } { --q_; return *this; } [[nodiscard]] constexpr quantity_kind operator--(int) requires requires(quantity_type q) { q--; } { return quantity_kind(q_--); } constexpr quantity_kind& operator+=(const quantity_kind& qk) requires requires(quantity_type q) { q += qk.common(); } { q_ += qk.common(); return *this; } constexpr quantity_kind& operator-=(const quantity_kind& qk) requires requires(quantity_type q) { q -= qk.common(); } { q_ -= qk.common(); return *this; } template constexpr quantity_kind& operator*=(const Rep2& rhs) requires requires(quantity_type q) { q *= rhs; } { q_ *= rhs; return *this; } template constexpr quantity_kind& operator*=(const quantity_kind, units::one, Rep2>& rhs) requires requires(quantity_type q) { q *= rhs.common(); } { q_ *= rhs.common(); return *this; } template constexpr quantity_kind& operator/=(const Rep2& rhs) requires requires(quantity_type q) { q /= rhs; } { gsl_ExpectsAudit(rhs != quantity_values::zero()); q_ /= rhs; return *this; } template constexpr quantity_kind& operator/=(const quantity_kind, units::one, Rep2>& rhs) requires requires(quantity_type q) { q /= rhs.common(); } { q_ /= rhs.common(); return *this; } template constexpr quantity_kind& operator%=(const Rep2& rhs) requires (!Quantity || Dimensionless) && requires(quantity_type q, const Rep2 r) { q %= r; } { gsl_ExpectsAudit(rhs != quantity_values::zero()); q_ %= rhs; return *this; } template constexpr quantity_kind& operator%=(const quantity_kind, units::one, Rep2>& rhs) requires requires(quantity_type q) { q %= rhs.common(); } { q_ %= rhs.common(); return *this; } constexpr quantity_kind& operator%=(const quantity_kind& qk) requires requires(quantity_type q) { q %= qk.common(); } { gsl_ExpectsAudit(qk.common().number() != quantity_values::zero()); q_ %= qk.common(); return *this; } // Hidden Friends // Below friend functions are to be found via argument-dependent lookup only template [[nodiscard]] friend constexpr QuantityKind auto operator*(const quantity_kind& qk, const Value& v) requires requires(quantity_type q) { { q * v } -> Quantity; } { return detail::make_quantity_kind(qk.common() * v); } template [[nodiscard]] friend constexpr QuantityKind auto operator*(const Value& v, const quantity_kind& qk) requires requires(quantity_type q) { { v * q } -> Quantity; } { return detail::make_quantity_kind(v * qk.common()); } template [[nodiscard]] friend constexpr QuantityKind auto operator/(const quantity_kind& qk, const Value& v) requires requires(quantity_type q) { { q / v } -> Quantity; } { gsl_ExpectsAudit(v != quantity_values::zero()); return detail::make_quantity_kind(qk.common() / v); } template [[nodiscard]] friend constexpr QuantityKind auto operator/(const Value& v, const quantity_kind& qk) requires requires(quantity_type q) { { v / q } -> Quantity; } { gsl_ExpectsAudit(qk.common().number() != quantity_values::zero()); return detail::downcasted_kind(v / qk.common()); } template [[nodiscard]] friend constexpr QuantityKind auto operator%(const quantity_kind& qk, const Value& v) requires requires(quantity_type q) { q % v; } { gsl_ExpectsAudit(v != quantity_values::zero()); return detail::make_quantity_kind(qk.common() % v); } [[nodiscard]] friend constexpr auto operator<=>(const quantity_kind& lhs, const quantity_kind& rhs) requires std::three_way_comparable { return lhs.common() <=> rhs.common(); } [[nodiscard]] friend constexpr bool operator==(const quantity_kind&, const quantity_kind&) = default; }; template QK2> [[nodiscard]] constexpr QuantityKind auto operator+(const QK1& lhs, const QK2& rhs) requires requires { lhs.common() + rhs.common(); } { return detail::make_quantity_kind(lhs.common() + rhs.common()); } template QK2> [[nodiscard]] constexpr QuantityKind auto operator-(const QK1& lhs, const QK2& rhs) requires requires { lhs.common() - rhs.common(); } { return detail::make_quantity_kind(lhs.common() - rhs.common()); } template [[nodiscard]] constexpr QuantityKind auto operator*(const QK& lhs, const Q& rhs) requires requires { lhs.common() * rhs; } { return detail::downcasted_kind(lhs.common() * rhs); } template [[nodiscard]] constexpr QuantityKind auto operator*(const Q& lhs, const QK& rhs) requires requires { lhs * rhs.common(); } { return detail::downcasted_kind(lhs * rhs.common()); } template QK2> [[nodiscard]] constexpr QuantityKind auto operator*(const QK1& lhs, const QK2& rhs) requires requires { lhs.common() * rhs.common(); } { return detail::downcasted_kind(lhs.common() * rhs.common()); } template [[nodiscard]] constexpr QuantityKind auto operator/(const QK& lhs, const Q& rhs) requires requires { lhs.common() / rhs; } { gsl_ExpectsAudit(rhs.number() != quantity_values::zero()); return detail::downcasted_kind(lhs.common() / rhs); } template [[nodiscard]] constexpr QuantityKind auto operator/(const Q& lhs, const QK& rhs) requires requires { lhs / rhs.common(); } { gsl_ExpectsAudit(rhs.common().number() != quantity_values::zero()); return detail::downcasted_kind(lhs / rhs.common()); } template QK2> [[nodiscard]] constexpr QuantityKind auto operator/(const QK1& lhs, const QK2& rhs) requires requires { lhs.common() / rhs.common(); } { return detail::downcasted_kind(lhs.common() / rhs.common()); } template [[nodiscard]] constexpr QuantityKind auto operator%(const QK& lhs, const D& rhs) requires requires { lhs.common() % rhs; } { gsl_ExpectsAudit(rhs.number() != quantity_values::zero()); return detail::make_quantity_kind(lhs.common() % rhs); } template QK2> [[nodiscard]] constexpr QuantityKind auto operator%(const QK1& lhs, const QK2& rhs) requires requires { lhs.common() % rhs.common(); } { gsl_ExpectsAudit(rhs.common().number() != quantity_values::zero()); return detail::make_quantity_kind(lhs.common() % rhs.common()); } template QK2> requires std::three_way_comparable_with [[nodiscard]] constexpr auto operator<=>(const QK1& lhs, const QK2& rhs) { return lhs.common() <=> rhs.common(); } template QK2> requires std::equality_comparable_with [[nodiscard]] constexpr bool operator==(const QK1& lhs, const QK2& rhs) { return lhs.common() == rhs.common(); } // type traits namespace detail { template inline constexpr bool is_quantity_kind> = true; } // namespace detail } // namespace units