std::is_constant_evaluated

来自cppreference.com
< cpp‎ | types
 
 
工具库
通用工具
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(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

可能的实现

// 此实现要求 C++23 if consteval 。
constexpr bool is_constant_evaluated() noexcept
{
    if consteval {
        return true;
    }
    else {
        return false;
    }
}

注解

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

由于 if consteval 不在 C++20 中, is_constant_evaluated 常由编译器扩展实现。

示例

#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

参阅

constexpr 说明符(C++11) 指定变量或函数的值能在编译时计算
consteval 说明符(C++20) 指定函数为立即函数,即对该函数的每次调用必须在常量求值中
constinit 说明符(C++20) 断言变量拥有静态初始化,即零初始化常量初始化