std:: log10, std:: log10f, std:: log10l

参数

返回值

若无错误发生，则返回 num 的常用（以 10 为底）对数（ log 10 (num) 或 lg(num) ）。

如果发生定义域错误，将返回一个由实现定义的值（在支持 NaN 的情况下返回 NaN）。

如果出现极点错误，将返回 -HUGE_VAL 、 -HUGE_VALF 或 -HUGE_VALL 。

错误处理

错误报告方式遵循 math_errhandling 中的规范。

当 num 小于零时会发生定义域错误。

当 num 为零时可能出现极点错误。

如果实现支持 IEEE 浮点算术 (IEC 60559)，

• 若参数为 ±0，则返回 -∞ 并引发 FE_DIVBYZERO 。
• 若参数为 1，则返回 +0。
• 若参数为负数，则返回 NaN 并引发 FE_INVALID 。
• 若参数为 +∞，则返回 +∞。
• 若参数为 NaN，则返回 NaN。

注释

额外的重载不需要完全按照 (A) 的形式提供。它们只需确保对于整数类型的实参 num ， std :: log10 ( num ) 能够产生与 std :: log10 ( static_cast < double > ( num ) ) 相同的效果。

示例

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "log10(1000) = " << std::log10(1000) << '\n'
              << "log10(0.001) = " << std::log10(0.001) << '\n'
              << "base-5 logarithm of 125 = "
              << std::log10(125) / std::log10(5) << '\n';
    // 特殊值
    std::cout << "log10(1) = " << std::log10(1) << '\n'
              << "log10(+Inf) = " << std::log10(INFINITY) << '\n';
    // 错误处理
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "log10(0) = " << std::log10(0) << '\n';
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_DIVBYZERO))
        std::cout << "    FE_DIVBYZERO raised\n";
}

log10(1000) = 3
log10(0.001) = -3
base-5 logarithm of 125 = 3
log10(1) = 0
log10(+Inf) = inf
log10(0) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

参见