scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl

매개변수

반환값

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

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

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

오류 처리

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

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

• 범위 오류가 발생하지 않는 한, FE_INEXACT 는 절대 발생하지 않습니다 (결과는 정확함).
• 범위 오류가 발생하지 않는 한, 현재 반올림 모드 는 무시됩니다.
• 만약 arg 가 ±0이면, 수정 없이 그대로 반환됩니다.
• 만약 arg 가 ±∞이면, 수정 없이 그대로 반환됩니다.
• 만약 exp 가 0이면, arg 가 수정 없이 그대로 반환됩니다.
• 만약 arg 가 NaN이면, NaN이 반환됩니다.

참고 사항

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

비록 scalbn 과 scalbln 이 해당 연산을 효율적으로 수행하도록 명세되어 있지만, 많은 구현에서 산술 연산자를 사용하여 2의 거듭제곱으로 곱셈이나 나눗셈을 수행하는 것보다 효율성이 낮습니다.

scalbln 함수가 제공되는 이유는, 가장 작은 양의 부동 소수점 값에서 가장 큰 유한 값으로 스케일링하기 위해 필요한 인자가 표준에서 보장하는 INT_MAX 인 32767 보다 클 수 있기 때문입니다. 특히, 80비트 long double 의 경우, 이 인자는 32828 입니다.

예제

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

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

참고문헌

참고 항목