log10, log10f, log10l

パラメータ

戻り値

エラーが発生しない場合、 arg の常用（底 10 の）対数（ log 10 (arg) または lg(arg) ）が返されます。

定義域エラーが発生した場合、実装定義の値が返されます（NaNがサポートされている場合はNaN）。

極エラーが発生した場合、 -HUGE_VAL 、 -HUGE_VALF または -HUGE_VALL が返されます。

エラーハンドリング

エラーは math_errhandling で指定された通りに報告されます。

ドメインエラーは、 arg がゼロ未満の場合に発生します。

arg がゼロの場合、極エラーが発生する可能性があります。

IEEE浮動小数点演算（IEC 60559）を実装がサポートしている場合、

• 引数が±0の場合、-∞が返され、 FE_DIVBYZERO が発生します。
• 引数が1の場合、+0が返されます
• 引数が負数の場合、NaNが返され、 FE_INVALID が発生します。
• 引数が+∞の場合、+∞が返されます
• 引数がNaNの場合、NaNが返されます。

例

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("log10(1000) = %f\n", log10(1000));
    printf("log10(0.001) = %f\n", log10(0.001));
    printf("base-5 logarithm of 125 = %f\n", log10(125) / log10(5));
    // special values
    printf("log10(1) = %f\n", log10(1));
    printf("log10(+Inf) = %f\n", log10(INFINITY));
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("log10(0) = %f\n", log10(0));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

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

参考文献

関連項目