Division operators

Synopses

Declared in <mp‐units/utility/safe_int.h>

Computes the quotient of dividing lhs by rhs.

Divides an integral scalar by a safe_int, checking for overflow.

template<typename U>
requires (detail::integral<U> && detail::same_sign_v<U, T>)
[[nodiscard]]
constexpr
safe_int</* implementation-defined */, ErrorPolicy>
operator/(
    U lhs,
    safe_int rhs);

Divides a floating‐point value by a safe_int.

template<typename U>
requires treat_as_floating_point<U>
[[nodiscard]]
constexpr
auto
operator/(
    U lhs,
    safe_int rhs)
requires requires { lhs / static_cast<U>(rhs.value_); };

Divides a safe_int by an integral scalar, checking for overflow.

template<typename U>
requires (detail::integral<U> && detail::same_sign_v<T, U>)
[[nodiscard]]
constexpr
safe_int</* implementation-defined */, ErrorPolicy>
operator/(
    safe_int lhs,
    U rhs);

Divides a safe_int by a floating‐point value.

template<typename U>
requires treat_as_floating_point<U>
[[nodiscard]]
constexpr
auto
operator/(
    safe_int lhs,
    U rhs)
requires requires { static_cast<U>(lhs.value_) / rhs; };

Divides a safe_int by a constrained value

template<
    typename U,
    typename CP>
requires detail::integral<U>
[[nodiscard]]
constexpr
safe_int</* implementation-defined */, ErrorPolicy>
operator/(
    safe_int lhs,
    constrained<U, CP> rhs);

Divides a safe_int by a non‐integral constrained value

template<
    typename U,
    typename CP>
requires (!std::integral<U>)
[[nodiscard]]
constexpr
constrained<decltype(std::declval<T>() / std::declval<U>()), CP>
operator/(
    safe_int lhs,
    constrained<U, CP> const& rhs);

Divides a constrained value by a safe_int

template<
    typename U,
    typename CP>
requires detail::integral<U>
[[nodiscard]]
constexpr
safe_int</* implementation-defined */, ErrorPolicy>
operator/(
    constrained<U, CP> lhs,
    safe_int rhs);

Divides a non‐integral constrained value by a safe_int

template<
    typename U,
    typename CP>
requires (!std::integral<U>)
[[nodiscard]]
constexpr
constrained<decltype(std::declval<U>() / std::declval<T>()), CP>
operator/(
    constrained<U, CP> const& lhs,
    safe_int rhs);

Return Value

  • the result of lhs / rhs; triggers ErrorPolicy::on_overflow on overflow or division by zero

  • the quotient, as a safe_int of the promoted result type; triggers ErrorPolicy::on_overflow on overflow

  • the quotient of lhs and the wrapped value

  • the quotient of the wrapped value and rhs

  • the wrapped quotient of the underlying values

Note

The return value should not be discarded.

Template Parameters

Name

Description

U

the integral scalar type

Parameters

Name

Description

lhs

the dividend

rhs

the divisor

Created with MrDocs