ilogb, ilogbf, ilogbl

공식적으로, 비편향 지수는 0이 아닌 arg 에 대해 부호 있는 정수 값으로서 log r |arg| 의 정수 부분이며, 여기서 r 은 FLT_RADIX 입니다.

매개변수

반환값

오류가 발생하지 않으면, arg 의 비편향 지수가 부호 있는 int 값으로 반환됩니다.

만약 arg 가 0이면, FP_ILOGB0 가 반환됩니다.

만약 arg 가 무한대이면, INT_MAX 가 반환됩니다.

만약 arg 가 NaN이면, FP_ILOGBNAN 이 반환됩니다.

올바른 결과가 INT_MAX 보다 크거나 INT_MIN 보다 작은 경우, 반환 값은 지정되지 않으며 도메인 오류 또는 범위 오류가 발생할 수 있습니다.

오류 처리

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

도메인 오류 또는 범위 오류는 arg 가 0, 무한대 또는 NaN일 때 발생할 수 있습니다.

올바른 결과가 INT_MAX 보다 크거나 INT_MIN 보다 작을 경우, 도메인 오류 또는 범위 오류가 발생할 수 있습니다

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

• 올바른 결과가 INT_MAX 보다 크거나 INT_MIN 보다 작은 경우, FE_INVALID 이 발생합니다.
• arg 가 ±0, ±∞, 또는 NaN인 경우, FE_INVALID 이 발생합니다.
• 다른 모든 경우에는, 결과는 정확하며 ( FE_INEXACT 는 절대 발생하지 않음) 현재 반올림 모드 는 무시됩니다.

참고 사항

만약 arg 가 0, 무한대, 또는 NaN이 아닌 경우, 반환되는 값은 ( int ) logb ( arg ) 와 정확히 동일합니다.

POSIX는 arg 가 0, 무한대, NaN이거나 올바른 결과가 int 범위를 벗어나는 경우 도메인 오류가 발생하도록 요구합니다.

POSIX는 또한 XSI 호환 시스템에서 올바른 결과가 INT_MAX 를 초과할 경우 반환되는 값이 INT_MAX 가 되고, 올바른 결과가 INT_MIN 미만일 경우 반환되는 값이 INT_MIN 이 되도록 요구합니다.

올바른 결과는 모든 알려진 구현에서 int 로 표현될 수 있습니다. 오버플로가 발생하려면, INT_MAX 가 LDBL_MAX_EXP * log2 ( FLT_RADIX ) 보다 작거나 INT_MIN 가 LDBL_MIN_EXP - LDBL_MANT_DIG ) * log2 ( FLT_RADIX ) 보다 커야 합니다.

ilogb 함수가 반환하는 지수의 값은 정규화 요구사항이 다르기 때문에 frexp 가 반환하는 지수보다 항상 1 작습니다: ilogb 가 반환하는 지수 e 에 대해, |arg*r -e
| 는 1과 r 사이에 있습니다(일반적으로 1 과 2 사이). 그러나 frexp 가 반환하는 지수 e 에 대해, |arg*2 -e
| 는 0.5 와 1 사이에 있습니다.

예제

#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    double f = 123.45;
    printf("주어진 숫자 %.2f 또는 16진수로 %a,\n", f, f);
    double f3;
    double f2 = modf(f, &f3);
    printf("modf()는 %.0f + %.2f를 생성합니다\n", f3, f2);
    int i;
    f2 = frexp(f, &i);
    printf("frexp()는 %f * 2^%d를 생성합니다\n", f2, i);
    i = ilogb(f);
    printf("logb()/ilogb()는 %f * %d^%d를 생성합니다\n", f/scalbn(1.0, i), FLT_RADIX, i);
    // 오류 처리
    feclearexcept(FE_ALL_EXCEPT);
    printf("ilogb(0) = %d\n", ilogb(0));
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID 발생");
}

주어진 숫자 123.45 또는 16진수로 0x1.edccccccccccdp+6,
modf()는 123 + 0.45를 생성합니다
frexp()는 0.964453 * 2^7를 생성합니다
logb()/ilogb()는 1.92891 * 2^6를 생성합니다
ilogb(0) = -2147483648
    FE_INVALID 발생

참고문헌

참고 항목