std:: saturate_cast

Convierte el valor x a un valor de tipo T , limitando x entre los valores mínimo y máximo del tipo T .

El programa está mal formado si ya sea T o U no es un tipo entero con signo o sin signo integer type (incluyendo standard integer type y extended integer type ).

Parámetros

Valor de retorno

• x , si x es representable como un valor de tipo T . De lo contrario,
• o bien el valor representable más grande o más pequeño de tipo T , el que esté más cerca del valor de x .

Notas

Implementación posible

Ver libstdc++ (GCC) .

Ejemplo

#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);
}

Véase también