替换<math.h>为<cmath>导致测试用例失败的问题排查

近期将代码中的<math.h>替换为<cmath>，编译无警告但测试用例失败。涉及的函数包括sqrt、abs（处理double类型，原本预期编译器会自动选用cmath版本而非stdlib版本）、tan。另有一文件已使用cmath，未影响测试。

测试代码：

#include <iostream>
#include <cmath>
int main() {

    double x = -0.546;
    double y = abs( x / sqrt(x*x + 1.0));
    double z = std::abs( x / sqrt(x*x + 1.0));

    std::cout << "Variable value is " << x << std::endl;
    std::cout << "Value of function using cmath " << z << std::endl;
    std::cout << "Value of function using stdlib " << y << std::endl;
    return 0;
}

在GCC 8.3.1 20191121编译器下的输出：

Value is -0.546
Value of function using cmath 0.479221
Value of function using stdlib 0

但在C++ Shell中输出的函数值为非零，表现不一致。

问题原因 #

1. <cmath>的标准规范是将数学函数置于std命名空间下，GCC 8.3.1这类旧版本编译器不会自动将std::abs的double重载导入全局命名空间。
2. 当调用不带命名空间的abs时，编译器匹配到了<stdlib.h>中的int abs(int)重载，将double类型的参数隐式转换为int（小数部分被截断），导致结果变为0。
3. C++ Shell使用的编译器版本较新，可能默认启用了扩展或实现了将std命名空间下常用数学函数重载导入全局的逻辑，因此能正确匹配到double版本的abs。

解决方案 #

• 显式指定命名空间：所有数学函数调用都加上std::前缀，比如std::abs、std::sqrt、std::tan，确保调用的是<cmath>中的重载版本，这是最可靠的做法。
• 全局导入std命名空间：在文件开头添加using namespace std;，但注意不要在头文件中使用，避免命名污染。
• 升级编译器：更新到较新版本的GCC（如GCC 10及以上），部分新版本会在包含<cmath>时自动将常用数学函数的重载导入全局命名空间，但显式指定std::仍更具可移植性。

内容的提问来源于stack exchange，提问作者Brinck