frexp, frexpf, frexpl

float       frexpf( float arg, int* exp );

double      frexp( double arg, int* exp );

long double frexpl( long double arg, int* exp );

#define frexp( arg, exp )

Параметры

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

Если arg равно нулю, возвращает ноль и записывает ноль в *exp.

В противном случае (если arg не равно нулю), при отсутствии ошибок возвращает значение x в диапазоне (-1;-0.5], [0.5; 1) и записывает целочисленное значение в *exp так, что x×2^(*exp)=arg.

Если значение, которое должно быть записано в *exp, выходит за пределы диапазона int, поведение не определено.

Если arg не является числом с плавающей точкой, поведение не определено.

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

Эта функция не подвержена ошибкам, указанным в math_errhandling.

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

• Если arg равно ±0, оно возвращается без изменений, а 0 записывается в *exp.
• Если arg равно ±∞, оно возвращается, а в *exp записывается неопределённое значение.
• Если arg — NaN, возвращается NaN, а в *exp записывается неопределённое значение.
• Исключения с плавающей точкой не генерируются.
• Если FLT_RADIX равно 2 (или является степенью 2), возвращаемое значение является точным, текущий режим округления игнорируется.

Примечания

В двоичной системе (где FLT_RADIX равно 2) frexp может быть реализована следующим образом:

{
    *exp = (value == 0) ? 0 : (int)(1 + logb(value));
    return scalbn(value, -(*exp));
}

Функцию frexp вместе с её обратной функцией ldexp можно использовать для работы с представлением числа с плавающей точкой без прямых побитовых операций.

Пример

#include <float.h>
#include <math.h>
#include <stdio.h>

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);
}

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

Ссылки

• Стандарт C23 (ISO/IEC 9899:2024):
• 7.12.6.4 Функции frexp (с. TBD)
• 7.25 Обобщённая по типу математика <tgmath.h> (с. TBD)
• F.10.3.4 Функции frexp (с. TBD)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.12.6.4 Функции frexp (с. TBD)
• 7.25 Обобщённая по типу математика <tgmath.h> (с. TBD)
• F.10.3.4 Функции frexp (с. TBD)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.12.6.4 Функции frexp (с. 243)
• 7.25 Обобщённая по типу математика <tgmath.h> (с. 373-375)
• F.10.3.4 Функции frexp (с. 521)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.12.6.4 Функции frexp (с. 224)
• 7.22 Обобщённая по типу математика <tgmath.h> (с. 335-337)
• F.9.3.4 Функции frexp (с. 458)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.5.4.2 Функция frexp

См. также