std:: saturate_cast

将值 x 转换为 T 类型，并将 x 钳制在类型 T 的最小值与最大值之间。

如果 T 或 U 不是有符号或无符号的 整数类型 （包括 标准整数类型 和 扩展整数类型 ），则程序非良构。

参数

返回值

• 若 x 可表示为类型 T 的值，则结果为 x 。否则，
• 结果为类型 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);
}

参见