log, logf, logl

パラメータ

戻り値

エラーが発生しない場合、引数の自然（底 e ）対数（ arg 、すなわち ln(arg) または log e (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("log(1) = %f\n", log(1));
    printf("base-5 logarithm of 125 = %f\n", log(125) / log(5));
    // 特殊な値
    printf("log(1) = %f\n", log(1));
    printf("log(+Inf) = %f\n", log(INFINITY));
    // エラー処理
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("log(0) = %f\n", log(0));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

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

参考文献

関連項目