modernize-use-std-numbers

查找可以替换为 C++20 中 numbers 头文件中的数学常量的常量和数学函数调用，并提供修复建议。不匹配使用该值的变量，而是提供对这些变量定义的替换。与常量计算模式匹配的函数调用将与 std::numbers 常量匹配并替换。宏的使用将被替换为相应的 std::numbers 常量，而不是更改宏定义。

以下列出了支持的 numbers 头文件中的常量

• e

• log2e

• log10e

• pi

• inv_pi

• inv_sqrtpi

• ln2

• ln10

• sqrt2

• sqrt3

• inv_sqrt3

• egamma

• phi

该列表目前包含截至 C++20 的所有常量。

替换使用匹配常量的类型，可以移除显式转换，例如在 std::numbers::e、std::numbers::e_v<float> 和 std::numbers::e_v<long double> 之间根据需要进行切换。

double sqrt(double);
double log2(double);
void sink(auto&&) {}
void floatSink(float);

#define MY_PI 3.1415926

void foo() {
    const double Pi = 3.141592653589;           // const double Pi = std::numbers::pi
    const auto Use = Pi / 2;                    // no match for Pi
    static constexpr double Euler = 2.7182818;  // static constexpr double Euler = std::numbers::e;

    log2(exp(1));                               // std::numbers::log2e;
    log2(Euler);                                // std::numbers::log2e;
    1 / sqrt(MY_PI);                            // std::numbers::inv_sqrtpi;
    sink(MY_PI);                                // sink(std::numbers::pi);
    floatSink(MY_PI);                           // floatSink(std::numbers::pi);
    floatSink(static_cast<float>(MY_PI));       // floatSink(std::numbers::pi_v<float>);
}

选项

DiffThreshold

一个浮点数，用于设置文字匹配常量的检测阈值。当 abs(literal - constant) < DiffThreshold 计算结果为 true 时，文字与常量匹配。默认值为 0.001。

IncludeStyle

指定使用哪种包含样式的字符串，llvm 或 google。默认值为 llvm。