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';
    // special values
    std::cout << "log10(1) = " << std::log10(1) << '\n'
              << "log10(+Inf) = " << std::log10(INFINITY) << '\n';
    // error handling
    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

関連項目