std:: div_sat

飽和 除算 x / y を計算します。 T が符号付き整数型であり、 x が T の最小値（最も負の値）で、 y == - 1 の場合、 T の最大値を返します。それ以外の場合は、 x / y を返します。

y は ​ 0 ​ であってはならず、そうでない場合の動作は未定義です。未定義動作が発生した場合、この関数呼び出しは core constant expression ではありません。

このオーバーロードは、 T が 整数型 である場合にのみ、オーバーロード解決に参加します。すなわち： signed char 、 short 、 int 、 long 、 long long 、拡張符号付き整数型、またはこれらの型の符号なしバージョンです。特に、 T は（CV修飾された可能性のある） bool 、 char 、 wchar_t 、 char8_t 、 char16_t 、および char32_t であってはなりません。これらの型は算術演算を意図していないためです。

パラメータ

戻り値

飽和 x / y .

注記

組み込みの整数演算子とは異なり、 integral promotion は x および y 引数には適用されません。

異なる型の2つの引数が渡された場合、その呼び出しはコンパイルに失敗します。つまり、 テンプレート引数推論 に関する動作は、 std::min や std::max と同じです。

最新のハードウェアアーキテクチャの多くは、 SIMDベクトル に対する飽和演算を効率的にサポートしています。これには、 x86 向けの SSE2 や、 ARM 向けの NEON が含まれます。

実装例

namespace detail {
template<class T>
concept standard_or_extended_integral =
     std::is_integral_v<T> &&
    !std::is_same_v<std::remove_cv_t<T>, bool> &&
    !std::is_same_v<std::remove_cv_t<T>, char> &&
    !std::is_same_v<std::remove_cv_t<T>, char8_t> &&
    !std::is_same_v<std::remove_cv_t<T>, char16_t> &&
    !std::is_same_v<std::remove_cv_t<T>, char32_t> &&
    !std::is_same_v<std::remove_cv_t<T>, wchar_t>;
} // namespace detail
template<detail::standard_or_extended_integral T>
constexpr T div_sat( T x, T y ) noexcept
{
    if constexpr (std::is_signed_v<T>)
        if (x == std::numeric_limits<T>::min() && y == -1)
            return std::numeric_limits<T>::max();
    return x / y;
}

例

#include <climits>
#include <numeric>
static_assert
(""
    && (std::div_sat<int>(6, 3) == 2) // not saturated
    && (std::div_sat<int>(INT_MIN, -1) == INT_MAX) // saturated
    && (std::div_sat<unsigned>(6, 3) == 2) // not saturated
);
int main() {}

関連項目

外部リンク