log1p, log1pf, log1pl

매개변수

반환값

오류가 발생하지 않으면 ln(1 + arg) 가 반환됩니다.

도메인 오류가 발생하면 구현에서 정의한 값이 반환됩니다(NaN을 지원하는 경우).

극점 오류가 발생하면, - HUGE_VAL , -HUGE_VALF , 또는 -HUGE_VALL 가 반환됩니다.

언더플로우로 인해 범위 오류가 발생하는 경우, 올바른 결과(반올림 후)가 반환됩니다.

오류 처리

오류는 math_errhandling 에 명시된 대로 보고됩니다.

도메인 오류는 arg 가 -1 보다 작을 때 발생합니다.

극점 오류는 arg 가 -1 일 때 발생할 수 있습니다.

구현이 IEEE 부동 소수점 연산(IEC 60559)을 지원하는 경우,

• 인자가 ±0인 경우, 수정 없이 그대로 반환됩니다.
• 인자가 -1인 경우, -∞가 반환되고 FE_DIVBYZERO 가 발생합니다.
• 인자가 -1보다 작은 경우, NaN이 반환되고 FE_INVALID 가 발생합니다.
• 인자가 +∞인 경우, +∞가 반환됩니다.
• 인자가 NaN인 경우, NaN이 반환됩니다.

참고 사항

expm1 함수와 log1p 함수는 금융 계산에 유용합니다. 예를 들어, 작은 일일 이자율을 계산할 때: (1+x) n
-1 는 expm1 ( n * log1p ( x ) ) 로 표현될 수 있습니다. 이러한 함수들은 정확한 역쌍곡선 함수 작성도 간소화합니다.

예제

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("log1p(0) = %f\n", log1p(0));
    printf("Interest earned in 2 days on $100, compounded daily at 1%%\n"
           " on a 30/360 calendar = %f\n",
           100*expm1(2*log1p(0.01/360)));
    printf("log(1+1e-16) = %g, but log1p(1e-16) = %g\n",
           log(1+1e-16), log1p(1e-16));
    // special values
    printf("log1p(-0) = %f\n", log1p(-0.0));
    printf("log1p(+Inf) = %f\n", log1p(INFINITY));
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("log1p(-1) = %f\n", log1p(-1));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

log1p(0) = 0.000000
Interest earned in 2 days on $100, compounded daily at 1%
 on a 30/360 calendar = 0.005556
log(1+1e-16) = 0, but log1p(1e-16) = 1e-16
log1p(-0) = -0.000000
log1p(+Inf) = Inf
log1p(-1) = -Inf
    errno == ERANGE: Result too large
    FE_DIVBYZERO raised

참고문헌

참고 항목