std::integral_constant

来自cppreference.com
< cpp‎ | types
 
 
元编程库
类型特征
类型类别
(C++11)
(C++14)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型属性
(C++11)
(C++11)
(C++14)
(C++11)
(C++11)(C++20 前*)
(C++11)(C++20 中弃用)
(C++11)
类型特征常量
integral_constantbool_constanttrue_typefalse_type
(C++11)(C++17)(C++11)(C++11)
元函数
(C++17)
受支持操作
关系与属性查询
类型修改
(C++11)(C++11)(C++11)
类型变换
(C++11)(C++23 中弃用)
(C++11)(C++23 中弃用)
(C++11)
(C++11)
(C++17)

(C++11)(C++20 前*)(C++17)
编译时有理数算术
编译时整数序列
 
在标头 <type_traits> 定义
template< class T, T v >
struct integral_constant;
(C++11 起)

std::integral_constant 包装特定类型的静态常量。它是 C++ 类型特征的基类。

如果程序添加了 std::integral_constant 的特化,那么行为未定义。

辅助别名模板

针对 Tbool 的常用情况定义辅助别名模板 std::bool_constant

template< bool B >
using bool_constant = integral_constant<bool, B>;
(C++17 起)

特化

针对 Tbool 的两种常用情形提供 typedef:

在标头 <type_traits> 定义
名字 定义
true_type std::integral_constant<bool, true>
false_type std::integral_constant<bool, false>

成员类型

类型 定义
value_type T
type std::integral_constant<T, v>

成员常量

名字
constexpr T value
[静态]
v
(公开静态成员常量)

成员函数

operator value_type
返回包装的值
(公开成员函数)
operator()
(C++14)
返回包装的值
(公开成员函数)

std::integral_constant::operator value_type

constexpr operator value_type() const noexcept;

转换函数。返回包装的值。

std::integral_constant::operator()

constexpr value_type operator()() const noexcept;
(C++14 起)

返回包装的值。此函数允许 std::integral_constant 被用作编译时函数对象的源。

可能的实现

template<class T, T v>
struct integral_constant
{
    static constexpr T value = v;
    using value_type = T;
    using type = integral_constant; // 使用注入类名
    constexpr operator value_type() const noexcept { return value; }
    constexpr value_type operator()() const noexcept { return value; } // C++14 起
};

注解

功能特性测试 标准 功能特性
__cpp_lib_integral_constant_callable 201304L (C++14) std::integral_constant::operator()
__cpp_lib_bool_constant 201505L (C++17) std::bool_constant

示例

#include <type_traits>
 
using two_t = std::integral_constant<int, 2>;
using four_t = std::integral_constant<int, 4>;
 
static_assert(not std::is_same_v<two_t, four_t>);
static_assert(two_t::value * 2 == four_t::value, "2*2 != 4");
static_assert(two_t() << 1 == four_t() >> 0, "2*2 != 4");
 
enum class E{ e1, e2 };
using c1 = std::integral_constant<E, E::e1>;
using c2 = std::integral_constant<E, E::e2>;
static_assert(c1::value != E::e2);
static_assert(c1() == E::e1);
static_assert(std::is_same_v<c2, c2>);
 
int main() {}

参阅

实现编译时整数数列
(类模板)