Spec-Zone.ru › C++

std::is_constant_evaluated

Определено в заголовке <type_traits>
constexpr bool is_constant_evaluated() noexcept;
(с C++20)

Определяет, происходит ли вызов функции в контексте постоянной оценки. Возвращает true если вычисление вызова происходит в рамках вычисления выражения или преобразования, которое является явной постоянной оценкой; в противном случае возвращает false.

Для определения, являются ли инициализаторы следующих переменных явной постоянной оценкой, компиляторы могут сначала выполнить пробную постоянную оценку:

  • переменные со ссылкой в типе или с квалификатором const для целочисленного или перечислимого типа;
  • статические и локальные переменные потока.

Не рекомендуется полагаться на результат в этом случае.

int y = 0;
const int a = std::is_constant_evaluated() ? y : 1;
// Trial constant evaluation fails. The constant evaluation is discarded.
// Variable a is dynamically initialized with 1
 
const int b = std::is_constant_evaluated() ? 2 : y;
// Constant evaluation with std::is_constant_evaluated() == true succeeds.
// Variable b is statically initialized with 2

Параметры

(нет)

Возвращаемое значение

true если вычисление вызова происходит в рамках вычисления выражения или преобразования, которое является явной постоянной оценкой; в противном случае false.

Возможная реализация

// This implementation requires C++23 if consteval.
constexpr bool is_constant_evaluated() noexcept
{
    if consteval
    {
        return true;
    }
    else 
    {
        return false;
    }
}

Примечания

При непосредственном использовании в качестве условия объявления static_assert или оператора constexpr if, std::is_constant_evaluated() всегда возвращает true.

Поскольку if consteval отсутствует в C++20, std::is_constant_evaluated обычно реализуется с помощью расширения компилятора.

Макрос проверки возможностей Значение Std Возможность
__cpp_lib_is_constant_evaluated 201811L (C++20) std::is_constant_evaluated

Пример

#include <cmath>
#include <iostream>
#include <type_traits>
 
constexpr double power(double b, int x)
{
    if (std::is_constant_evaluated() && !(b == 0.0 && x < 0))
    {
        // A constant-evaluation context: Use a constexpr-friendly algorithm.
        if (x == 0)
            return 1.0;
        double r {1.0};
        double p {x > 0 ? b : 1.0 / b};
        for (auto u = unsigned(x > 0 ? x : -x); u != 0; u /= 2)
        {
            if (u & 1)
                r *= p;
            p *= p;
        }
        return r;
    }
    else
    {
        // Let the code generator figure it out.
        return std::pow(b, double(x));
    }
}
 
int main()
{
    // A constant-expression context
    constexpr double kilo = power(10.0, 3);
    int n = 3;
    // Not a constant expression, because n cannot be converted to an rvalue
    // in a constant-expression context
    // Equivalent to 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) утверждает, что переменная имеет статическую инициализацию, т.е. нулевую инициализацию и постоянную инициализацию

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/types/is_constant_evaluated

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API