Namespaces
Variants

expm1, expm1f, expm1l

From cppreference.net
< c ‎ | numeric ‎ | math
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
Exponential functions
(C23)
(C99)
expm1
(C99)
(C23)
(C23)

Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99) (C99) (C99)
(C23) (C23) (C23) (C23)
Floating-point manipulation
Narrowing operations
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quantum and quantum exponent
Decimal re-encoding functions
Total order and payload functions
Classification
Error and gamma functions
(C99)
(C99)
(C99)
(C99)
Types
Macro constants
Special floating-point values
Arguments and return values
Error handling
Fast operation indicators
헤더 파일에 정의됨 <math.h>
float expm1f ( float arg ) ;
(1) (C99부터)
double expm1 ( double arg ) ;
(2) (C99부터)
long double expm1l ( long double arg ) ;
(3) (C99부터)
헤더 파일에 정의됨 <tgmath.h>
#define expm1( arg )
(4) (C99부터)
1-3) 주어진 거듭제곱 arg 에 대해 e (오일러 수, 2.7182818 )를 계산한 값에서 1.0 을 뺀 값을 계산합니다. arg 가 0에 가까운 경우 이 함수는 exp ( arg ) - 1.0 표현식보다 더 정확합니다.
4) 타입-제네릭 매크로: arg long double 타입을 가지면 expm1l 이 호출됩니다. 그렇지 않고 arg 가 정수 타입이나 double 타입을 가지면 expm1 가 호출됩니다. 그 외의 경우에는 expm1f 가 호출됩니다.

목차

매개변수

arg - 부동소수점 값

반환값

오류가 발생하지 않으면 e arg
-1
가 반환됩니다.

오버플로로 인한 범위 오류가 발생하는 경우, +HUGE_VAL , +HUGE_VALF , 또는 +HUGE_VALL 가 반환됩니다.

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

오류 처리

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

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

  • 인수가 ±0인 경우, 수정 없이 반환됩니다
  • 인수가 -∞인 경우, -1을 반환합니다
  • 인수가 +∞인 경우, +∞를 반환합니다
  • 인수가 NaN인 경우, NaN을 반환합니다

참고 사항

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

IEEE 호환 타입 double 의 경우, 709.8 < arg 이면 오버플로우가 보장됩니다.

예제

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("expm1(1) = %f\n", expm1(1));
    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("exp(1e-16)-1 = %g, but expm1(1e-16) = %g\n",
           exp(1e-16)-1, expm1(1e-16));
    // special values
    printf("expm1(-0) = %f\n", expm1(-0.0));
    printf("expm1(-Inf) = %f\n", expm1(-INFINITY));
    //error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("expm1(710) = %f\n", expm1(710));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_OVERFLOW))
        puts("    FE_OVERFLOW raised");
}

가능한 출력:

expm1(1) = 1.718282
Interest earned in 2 days on $100, compounded daily at 1%
 on a 30/360 calendar = 0.005556
exp(1e-16)-1 = 0, but expm1(1e-16) = 1e-16
expm1(-0) = -0.000000
expm1(-Inf) = -1.000000
expm1(710) = inf
    errno == ERANGE: Result too large
    FE_OVERFLOW raised

참고문헌

  • C23 표준 (ISO/IEC 9899:2024):
  • 7.12.6.3 expm1 함수들 (p: TBD)
  • 7.25 타입-제네릭 수학 <tgmath.h> (p: TBD)
  • F.10.3.3 expm1 함수들 (p: TBD)
  • C17 표준 (ISO/IEC 9899:2018):
  • 7.12.6.3 expm1 함수들 (p: 177)
  • 7.25 타입-제네릭 수학 <tgmath.h> (p: 272-273)
  • F.10.3.3 expm1 함수들 (p: 379)
  • C11 표준 (ISO/IEC 9899:2011):
  • 7.12.6.3 expm1 함수 (p: 243)
  • 7.25 타입-제네릭 수학 <tgmath.h> (p: 373-375)
  • F.10.3.3 expm1 함수 (p: 521)
  • C99 표준 (ISO/IEC 9899:1999):
  • 7.12.6.3 expm1 함수 (p: 223-224)
  • 7.22 타입-제네릭 수학 <tgmath.h> (p: 335-337)
  • F.9.3.3 expm1 함수 (p: 458)

참고 항목

(C99) (C99)
주어진 거듭제곱으로 올린 e 값을 계산합니다 ( e x )
(함수)
(C99) (C99) (C99)
주어진 거듭제곱으로 올린 2 값을 계산합니다 ( 2 x )
(함수)
(C99) (C99) (C99)
1에 주어진 숫자를 더한 값의 자연 (밑 e ) 로그를 계산합니다 ( ln(1+x) )
(함수)