std:: saturate_cast

Преобразует значение x в значение типа T , ограничивая x между минимальным и максимальным значениями типа T .

Программа является некорректной, если либо T , либо U не является знаковым или беззнаковым целочисленным типом (включая стандартные целочисленные типы и расширенные целочисленные типы ).

Параметры

Возвращаемое значение

• x , если 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);
}

Смотрите также