std::saturate_cast - cppreference.com (original) (raw)

| | | | | ------------------------------------------------------------------------- | | ------------- | | template< class T, class U > constexpr T saturate_cast( U x ) noexcept; | | (since C++26) |

Converts the value x to a value of type T, clamping x between the minimum and maximum values of type T.

The program is ill-formed if either T or U is not a signed or unsigned integer type (including standard integer type and extended integer type).

Contents

• 1 Parameters
• 2 Return value
• 3 Notes
• 4 Possible implementation
• 5 Example
• 6 See also

[edit] Parameters

[edit] Return value

• x, if x is representable as a value of type T. Otherwise,
• either the largest or smallest representable value of type T, whichever is closer to the value of x.

[edit] Notes

[edit] Possible implementation

See libstdc++ (GCC).

[edit] Example

[edit] See also

| | reinterpret the object representation of one type as that of another (function template) [edit] | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | clamps a value between a pair of boundary values (function template) [edit] | | | checks if an integer value is in the range of a given integer type (function template) [edit] |