Defined in header <utility> | ||
|---|---|---|
template< class R, class T > constexpr bool in_range( T t ) noexcept; | (since C++20) |
Returns true if the value of t is in the range of values that can be represented in R, that is, if t can be converted to R without data loss.
It is a compile-time error if either T or R is not a signed or unsigned integer type (including standard integer type and extended integer type).
| t | - | value to test |
true if the value of t is representable in R, false otherwise.
template<class R, class T>
constexpr bool in_range(T t) noexcept
{
return std::cmp_greater_equal(t, std::numeric_limits<R>::min()) &&
std::cmp_less_equal(t, std::numeric_limits<R>::max());
} |
This function cannot be used with enums (including std::byte), char, char8_t, char16_t, char32_t, wchar_t and bool.
| Feature-test macro | Value | Std | Comment |
|---|---|---|---|
__cpp_lib_integer_comparison_functions | 202002L | (C++20) | Integer comparison functions |
#include <iostream>
#include <utility>
int main()
{
std::cout << std::boolalpha;
std::cout << std::in_range<std::size_t>(-1) << '\n';
std::cout << std::in_range<std::size_t>(42) << '\n';
}Output:
false true
|
(C++20) | returns the smaller of the given values (niebloid) |
|
(C++20) | returns the greater of the given values (niebloid) |
|
(C++20) | clamps a value between a pair of boundary values (niebloid) |
|
(C++20) | linear interpolation function (function) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/utility/in_range