std::is_constant_evaluated

< cpp‎ | types
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
 
类型支持
基本类型
基础类型
定宽整数类型 (C++11)
数值极限
C 数值极限接口
运行时类型信息
类型特性
类型类别
(C++11)
(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)
类型特性常量
元函数
(C++17)
常量求值语境
is_constant_evaluated
(C++20)
受支持操作
关系与属性查询
类型修改
(C++11)(C++11)(C++11)
类型变换
(C++11)
(C++11)
(C++17)
(C++11)(C++20 前)(C++17)
 
定义于头文件 <type_traits>
constexpr bool is_constant_evaluated() noexcept;
(C++20 起)

检查函数调用是否出现在常量求值的场合。若对调用的求值出现在明显常量求值的表达式或类型转换的求值中,返回 true ,否则返回 false

以下表达式(包括到目标类型的隐式类型转换)是明显常量求值的:

  • 语法上要求常量表达式的场合,包括
  • 静态及线程局域变量的初始化器,若该初始化器的所有子表达式(含构造函数调用和隐式转换)都是常量表达式(即该初始化器为常量初始化器

测试最后两个条件可能涉及对初始化器的试探性常量求值。不建议依赖此时的结果。

int y;
const int a = std::is_constant_evaluated() ? y : 1;
// 试探性常量求值失败,常量求值被舍弃。
// 变量 a 动态初始化为 1
 
const int b = std::is_constant_evaluated() ? 2 : y;
// 常量求值(std::is_constant_evaluation() == true)成功。
// 变量 b 静态初始化为 2

参数

(无)

返回值

若对调用的求值出现在明显常量求值的表达式或类型转换的求值中,返回 true ,否则返回 false

注意

std::is_constant_evaluated() 直接作为 static_assert 声明constexpr if 语句的条件时,返回值总是 true

示例

#include <type_traits>
#include <cmath>
#include <iostream>
 
constexpr double power(double b, int x)
{
    if (std::is_constant_evaluated() && !(b == 0.0 && x < 0)) {
        // 常量求值语境:使用 constexpr 友好的算法。
        if (x == 0)
            return 1.0;
        double r = 1.0, p = x > 0 ? b : 1.0 / b;
        auto u = unsigned(x > 0 ? x : -x);
        while (u != 0) {
            if (u & 1) r *= p;
            u /= 2;
            p *= p;
        }
        return r;
    } else {
        // 令代码生成器生成。
        return std::pow(b, double(x));
    }
}
 
int main()
{
    // 常量表达式语句
    constexpr double kilo = power(10.0, 3);
    int n = 3;
    // 非常量表达式,因为 n 不能在常量表达式语境中转换成右值
    // 等价于 std::pow(10.0, double(n))
    double mucho = power(10.0, n);
 
    std::cout << kilo << " " << mucho << "\n"; // (3)
}

输出:

1000 1000