ilogb, ilogbf, ilogbl

int ilogbf( float arg );

int ilogb( double arg );

int ilogbl( long double arg );

#define ilogb( arg )

#define FP_ILOGB0 /*implementation-defined*/

#define FP_ILOGBNAN /*implementation-defined*/

Формально, смещённый экспонент — это целая часть log_r|arg| как значение целого числа со знаком для ненулевого arg, где r является FLT_RADIX.

Параметры

Возвращаемое значение

Если ошибки не произошли, смещённый экспонент arg возвращается как значение signed int.

Если arg равно нулю, возвращается FP_ILOGB0.

Если arg бесконечен, возвращается INT_MAX.

Если arg — NaN, возвращается FP_ILOGBNAN.

Если правильный результат больше INT_MAX или меньше INT_MIN, возвращаемое значение не определено, и может произойти ошибка домена или ошибка диапазона.

Обработка ошибок

Ошибки сообщаются в соответствии со спецификацией в math_errhandling.

Ошибка домена или ошибка диапазона может произойти, если arg равно нулю, бесконечен или NaN.

Если правильный результат больше INT_MAX или меньше INT_MIN, может произойти ошибка домена или ошибка диапазона.

Если реализация поддерживает арифметику с плавающей запятой IEEE (IEC 60559),

• Если правильный результат больше INT_MAX или меньше INT_MIN, поднимается FE_INVALID.
• Если arg равно ±0, ±∞ или NaN, поднимается FE_INVALID.
• Во всех остальных случаях результат точный (FE_INEXACT никогда не поднимается), и текущий режим округления игнорируется.

Примечания

Если arg не равно нулю, бесконечности или NaN, возвращаемое значение точно эквивалентно (int)logb(arg).

POSIX требует, чтобы произошла ошибка домена, если arg равно нулю, бесконечности, 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, всегда на 1 меньше, чем экспонента, возвращаемая frexp, из-за различных требований нормализации: для экспоненты e, возвращаемой ilogb, |arg*r^-e| находится между 1 и r (обычно между 1 и 2), но для экспоненты e возвращаемой frexp, |arg*2^-e| находится между 0.5 и 1.

Пример

#include <stdio.h>
#include <math.h>
#include <float.h>
#include <fenv.h>
 
#pragma STDC FENV_ACCESS ON
int main(void)
{
    double f = 123.45;
    printf("Given the number %.2f or %a in hex,\n", f, f);
 
    double f3;
    double f2 = modf(f, &f3);
    printf("modf() makes %.0f + %.2f\n", f3, f2);
 
    int i;
    f2 = frexp(f, &i);
    printf("frexp() makes %f * 2^%d\n", f2, i);
 
    i = ilogb(f);
    printf("logb()/ilogb() make %f * %d^%d\n", f/scalbn(1.0, i), FLT_RADIX, i);
 
    // error handling
    feclearexcept(FE_ALL_EXCEPT);
    printf("ilogb(0) = %d\n", ilogb(0));
    if(fetestexcept(FE_INVALID)) puts("    FE_INVALID raised");
}

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

Ссылки

• Стандарт C11 (ISO/IEC 9899:2011):
• 7.12/8 Математика <math.h> (стр: 232)
• 7.12.6.5 Функции ilogb (стр: 244)
• 7.25 Универсальная математика <tgmath.h> (стр: 373-375)
• F.10.3.5 Функции ilogb (стр: 521)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.12/8 Математика <math.h> (стр: 213)
• 7.12.6.5 Функции ilogb (стр: 224-225)
• 7.22 Универсальная математика <tgmath.h> (стр: 335-337)
• F.9.3.5 Функции ilogb (стр: 458)

См. также