std::is_integral

在标头 `<type_traits>` 定义
template< class T > struct is_integral;		(C++11 起)

std::is_integral 是一元类型特性 (UnaryTypeTrait) 。

检查 T 是否为整数类型。

若 T 为 bool、char、char8_t (C++20 起)、char16_t、char32_t、wchar_t、short、int、 long、long long，或任何实现定义的扩展整数类型，包含任何有符号、无符号及 cv 限定的变体，那么成员常量 value 等于 true。对于其它类型，value 等于 false。

添加 std::is_integral 或 std::is_integral_v 的特化的程序行为未定义。

模板形参

T

-

要检查的类型

辅助变量模板

template< class T > inline constexpr bool is_integral_v = is_integral<T>::value;		(C++17 起)

继承自 std::integral_constant

成员常量

value

[静态]

如果 T 为整数类型那么是 true，否则是 false
(公开静态成员常量)

成员函数

operator bool	将对象转换到 bool，返回 value (公开成员函数)
operator() (C++14)	返回 value (公开成员函数)

成员类型

类型	定义
`value_type`	bool
`type`	std::integral_constant<bool, value>

可能的实现

// 注意 这个实现使用了 C++20 特性
template< class T >
struct is_integral : std::bool_constant<
    requires (T t, T* p, void (*f)(T)) // T* 参数不包括引用类型
    {
        reinterpret_cast<T>(t); // 排除class类型
        f(0); // 排除枚举类型
        p + t; // 排除除整型以外所有尚未排除的类型
    }> {};

示例

运行此代码

#include <iostream>
#include <type_traits>
 
class A {};
 
enum E : int {};
 
template <class T>
T f(T i)
{
    static_assert(std::is_integral<T>::value, "Integral required.");
    return i;
}
 
int main() 
{
    std::cout << std::boolalpha;
    std::cout << std::is_integral<A>::value << '\n';
    std::cout << std::is_integral<E>::value << '\n';
    std::cout << std::is_integral<float>::value << '\n';
    std::cout << std::is_integral<int>::value << '\n';
    std::cout << std::is_integral<bool>::value << '\n';
    std::cout << f(123) << '\n';
}

输出：

false
false
false
true
true
123

参阅

integral (C++20)	指定类型为整数类型 (概念)
is_integer [静态]	鉴别整数类型 (`std::numeric_limits<T>` 的公开静态成员常量)
is_floating_point (C++11)	检查类型是否是浮点类型 (类模板)
is_arithmetic (C++11)	检查类型是否为算术类型 (类模板)
is_enum (C++11)	检查类型是否是枚举类型 (类模板)

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库