命名空间
变体
操作

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 添加了特化,则行为未定义。

内容

[编辑] 辅助别名模板

辅助别名模板 std::bool_constant 用于 Tbool 的常见情况。

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

[编辑] 特化

Tbool 的常见情况提供了两个类型定义

定义在头文件中 <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; // using injected-class-name
    constexpr operator value_type() const noexcept { return value; }
    constexpr value_type operator()() const noexcept { return value; } // since c++14
};

[编辑] 备注

功能测试 Std 功能
__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() {}

[编辑] 另请参阅

实现编译时整数序列
(类模板) [编辑]