Namespaces
Variants

std:: ilogb, std:: ilogbf, std:: ilogbl

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
ilogb
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
헤더 파일에 정의됨 <cmath>
(1)
int ilogb ( float num ) ;

int ilogb ( double num ) ;

int ilogb ( long double num ) ;
(C++11부터)
(C++23까지)
constexpr int ilogb ( /* floating-point-type */ num ) ;
(C++23부터)
int ilogbf ( float num ) ;
(2) (C++11부터)
(C++23부터 constexpr)
int ilogbl ( long double num ) ;
(3) (C++11부터)
(C++23부터 constexpr)
#define FP_ILOGB0   /* implementation-defined */
(4) (C++11부터)
#define FP_ILOGBNAN /* implementation-defined */
(5) (C++11부터)
헤더 파일에 정의됨 <cmath>
template < class Integer >
int ilogb ( Integer num ) ;
(A) (C++11부터)
(C++23부터 constexpr)
1-3) 부동 소수점 인자 num 에서 비편향 지수(unbiased exponent) 값을 추출하고, 부호 있는 정수 값으로 반환합니다. 라이브러리는 모든 cv-한정자가 없는 부동 소수점 타입에 대한 std::ilogb 의 오버로드를 매개변수 num 의 타입으로 제공합니다. (C++23부터)
4) 정수 상수 표현식으로 확장되며, 그 값은 INT_MIN 또는 - INT_MAX 입니다.
5) 정수 상수 표현식으로 확장되며, 그 값은 INT_MIN 또는 + INT_MAX 입니다.
A) 모든 정수 타입에 대해 추가적인 오버로드가 제공되며, 이들은 double 로 처리됩니다.

공식적으로, 비편향 지수는 0이 아닌 num 에 대해 부호 있는 정수 값으로서 log r |num| 의 정수 부분이며, 여기서 r 은 std:: numeric_limits < T > :: radix 이고 T 는 num 의 부동소수점 타입입니다.

목차

매개변수

num - 부동 소수점 또는 정수 값

반환값

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

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

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

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

올바른 결과가 INT_MAX 보다 크거나 INT_MIN 보다 작을 경우, 반환 값은 지정되지 않습니다.

오류 처리

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

num 이 0, 무한대 또는 NaN인 경우 도메인 오류 또는 범위 오류가 발생할 수 있습니다.

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

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

참고 사항

만약 num 이 0, 무한대, 또는 NaN이 아니라면, 반환되는 값은 정확히 static_cast < int > ( std:: logb ( num ) ) 와 동일합니다.

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

POSIX는 또한 XSI 준수 시스템에서 올바른 결과가 INT_MAX 보다 클 때 반환되는 값은 INT_MAX 이고, 올바른 결과가 INT_MIN 보다 작을 때 반환되는 값은 INT_MIN 이라고 요구합니다.

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

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

추가 오버로드는 반드시 (A) 와 정확히 동일하게 제공될 필요는 없습니다. 정수 타입의 인수 num 에 대해 std :: ilogb ( num ) 가 std :: ilogb ( static_cast < double > ( num ) ) 와 동일한 효과를 가지도록 보장하기에 충분하기만 하면 됩니다.

예제

다양한 부동 소수점 분해 함수들을 비교합니다:

이 코드 실행 
#include <cfenv>
#include <cmath>
#include <iostream>
#include <limits>
// #pragma STDC FENV_ACCESS ON
int main()
{
    double f = 123.45;
    std::cout << "Given the number " << f << " or " << std::hexfloat
              << f << std::defaultfloat << " in hex,\n";
    double f3;
    double f2 = std::modf(f, &f3);
    std::cout << "modf() makes " << f3 << " + " << f2 << '\n';
    int i;
    f2 = std::frexp(f, &i);
    std::cout << "frexp() makes " << f2 << " * 2^" << i << '\n';
    i = std::ilogb(f);
    std::cout << "logb()/ilogb() make " << f / std::scalbn(1.0, i) << " * "
              << std::numeric_limits<double>::radix
              << "^" << std::ilogb(f) << '\n';
    // error handling
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "ilogb(0) = " << std::ilogb(0) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

가능한 출력: 

Given the number 123.45 or 0x1.edccccccccccdp+6 in hex,
modf() makes 123 + 0.45
frexp() makes 0.964453 * 2^7
logb()/ilogb() make 1.92891 * 2^6
ilogb(0) = -2147483648
    FE_INVALID raised

참고 항목

(C++11) (C++11)
숫자를 가수와 밑수- 2 지수로 분해
(함수)
(C++11) (C++11) (C++11)
숫자의 지수를 추출
(함수)
(C++11) (C++11) (C++11) (C++11) (C++11) (C++11)
숫자에 FLT_RADIX 의 거듭제곱을 곱함
(함수)
C 문서 for ilogb