std:: saturate_cast

値 x を型 T の値に変換し、 x を型 T の最小値と最大値の間でクランプします。

T または U のいずれかが符号付きまたは符号なしの 整数型 （ 標準整数型 および 拡張整数型 を含む）でない場合、プログラムは不適格です。

パラメータ

戻り値

• x 、型 T の値として表現可能な場合。それ以外の場合、
• 型 T の表現可能な最大値または最小値のいずれか、 x の値により近い方。

注記

実装例

以下を参照してください libstdc++ (GCC) 。

例

#include <cstdint>
#include <limits>
#include <numeric>
int main()
{
    constexpr std::int16_t x1{696};
    constexpr std::int8_t x2 = std::saturate_cast<std::int8_t>(x1);
    static_assert(x2 == std::numeric_limits<std::int8_t>::max());
    constexpr std::uint8_t x3 = std::saturate_cast<std::uint8_t>(x1);
    static_assert(x3 == std::numeric_limits<std::uint8_t>::max());
    constexpr std::int16_t y1{-696};
    constexpr std::int8_t y2 = std::saturate_cast<std::int8_t>(y1);
    static_assert(y2 == std::numeric_limits<std::int8_t>::min());
    constexpr std::uint8_t y3 = std::saturate_cast<std::uint8_t>(y1);
    static_assert(y3 == 0);
}

関連項目