Computes the nearest quantity point with integer representation and unit type To to qp

Synopsis

Declared in <mp‐units/math.h>

template<
    Unit auto To,
    auto R,
    auto PO,
    typename Rep>
[[nodiscard]]
constexpr
QuantityPointOf<quantity_point<R, PO, Rep>::quantity_spec> auto
round(quantity_point<R, PO, Rep> const& qp) noexcept
requires requires {
    mp_units::floor<To>(qp);
    representation_values<Rep>::one();
  } && std::constructible_from<std::int64_t, Rep>;

Description

Returns the value res representable in To unit that is the closest to qp. If there are two such values, returns the even value (that is, the value res such that res % 2 == 0).

Return Value

QuantityPoint The quantity rounded to the nearest unit To, rounding to even in halfway cases.

Note

The return value should not be discarded.

Parameters

Name

Description

qp

Quantity point being the base of the operation

Created with MrDocs