ldexp, ldexpf, ldexpl

매개변수

반환값

오류가 발생하지 않으면, arg 에 2의 exp 제곱을 곱한 값( arg×2 exp
)이 반환됩니다.

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

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

오류 처리

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

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

• 범위 오류가 발생하지 않는 한, FE_INEXACT 가 발생하지 않음 (결과가 정확함)
• 범위 오류가 발생하지 않는 한, 현재 반올림 모드 는 무시됨
• arg 가 ±0인 경우, 수정 없이 반환됨
• arg 가 ±∞인 경우, 수정 없이 반환됨
• exp 가 0인 경우, arg 가 수정 없이 반환됨
• arg 가 NaN인 경우, NaN이 반환됨

참고 사항

2진 시스템(여기서 FLT_RADIX 가 2 인 경우)에서, ldexp 는 scalbn 와 동등합니다.

함수 ldexp ("지수 로드")는 그 쌍대 함수인 frexp 와 함께 직접적인 비트 조작 없이 부동소수점 수의 표현을 조작하는 데 사용될 수 있습니다.

많은 구현에서, ldexp 는 산술 연산자를 사용하여 2의 거듭제곱으로 곱하거나 나누는 것보다 효율성이 낮습니다.

예제

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("ldexp(7, -4) = %f\n", ldexp(7, -4));
    printf("ldexp(1, -1074) = %g (minimum positive subnormal double)\n",
            ldexp(1, -1074));
    printf("ldexp(nextafter(1,0), 1024) = %g (largest finite double)\n",
            ldexp(nextafter(1,0), 1024));
    // special values
    printf("ldexp(-0, 10) = %f\n", ldexp(-0.0, 10));
    printf("ldexp(-Inf, -1) = %f\n", ldexp(-INFINITY, -1));
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("ldexp(1, 1024) = %f\n", ldexp(1, 1024));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_OVERFLOW))
        puts("    FE_OVERFLOW raised");
}

ldexp(7, -4) = 0.437500
ldexp(1, -1074) = 4.94066e-324 (minimum positive subnormal double)
ldexp(nextafter(1,0), 1024) = 1.79769e+308 (largest finite double)
ldexp(-0, 10) = -0.000000
ldexp(-Inf, -1) = -inf
ldexp(1, 1024) = inf
    errno == ERANGE: Numerical result out of range
    FE_OVERFLOW raised

참고문헌

참고 항목