frexp, frexpf, frexpl
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Определено в заголовке
<math.h>
|
||
|
float
frexpf
(
float
arg,
int
*
exp
)
;
|
(1) | (начиная с C99) |
|
double
frexp
(
double
arg,
int
*
exp
)
;
|
(2) | |
|
long
double
frexpl
(
long
double
arg,
int
*
exp
)
;
|
(3) | (начиная с C99) |
|
Определено в заголовке
<tgmath.h>
|
||
|
#define frexp( arg, exp )
|
(4) | (начиная с C99) |
x
на нормализованную дробь и целочисленную степень двойки.
frexpl
вызывается. В противном случае, если
arg
имеет целочисленный тип или тип
double
,
frexp
вызывается. В остальных случаях вызывается
frexpf
соответственно.
Содержание |
Параметры
| 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, он возвращается без изменений, и в * exp сохраняется0. -
Если
argравен ±∞, он возвращается, и в * exp сохраняется неопределённое значение. -
Если
argявляется NaN, возвращается NaN, и в * exp сохраняется неопределённое значение. - Исключения с плавающей точкой не возникают.
- Если FLT_RADIX равен 2 (или степени двойки), возвращаемое значение является точным, текущий режим округления игнорируется.
Примечания
В двоичной системе (где
FLT_RADIX
равен
2
),
frexp
может быть реализована как
` и `` сохранен без изменений, как и требовалось. HTML-теги и атрибуты также остались нетронутыми.
Функция
frexp
, вместе со своей парной функцией
ldexp
, может использоваться для манипуляции представлением числа с плавающей запятой без прямых битовых операций.
Пример
#include <float.h> #include <math.h> #include <stdio.h> int main(void) { double f = 123.45; printf("Дано число %.2f или %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); }
Возможный вывод:
Дано число 123.45 или 0x1.edccccccccccdp+6 в шестнадцатеричном виде, modf() создает 123 + 0.45 frexp() создает 0.964453 * 2^7 logb()/ilogb() создают 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
Смотрите также
|
(C99)
(C99)
|
умножает число на
2
в указанной степени
(функция) |
|
(C99)
(C99)
(C99)
|
извлекает экспоненту заданного числа
(функция) |
|
(C99)
(C99)
(C99)
|
извлекает экспоненту заданного числа
(функция) |
|
(C99)
(C99)
|
разбивает число на целую и дробную части
(функция) |
|
Документация C++
для
frexp
|
|