modf, modff, modfl
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Определено в заголовочном файле
<math.h>
|
||
|
float
modff
(
float
arg,
float
*
iptr
)
;
|
(1) | (начиная с C99) |
|
double
modf
(
double
arg,
double
*
iptr
)
;
|
(2) | |
|
long
double
modfl
(
long
double
arg,
long
double
*
iptr
)
;
|
(3) | (начиная с C99) |
Содержание |
Параметры
| arg | - | значение с плавающей точкой |
| iptr | - | указатель на значение с плавающей точкой для сохранения целой части |
Возвращаемое значение
Если ошибок не возникает, возвращает дробную часть arg с тем же знаком, что и arg . Целая часть помещается в значение, на которое указывает iptr .
Сумма возвращаемого значения и значения, хранящегося в * iptr даёт arg (с учётом округления).
Обработка ошибок
Эта функция не подвержена никаким ошибкам, указанным в
math_errhandling
.
Если реализация поддерживает арифметику с плавающей запятой IEEE (IEC 60559),
- Если arg равен ±0, возвращается ±0, и ±0 сохраняется в * iptr .
- Если arg равен ±∞, возвращается ±0, и ±∞ сохраняется в * iptr .
- Если arg является NaN, возвращается NaN, и NaN сохраняется в * iptr .
- Возвращаемое значение является точным, текущий режим округления игнорируется.
Примечания
Эта функция ведет себя так, как если бы была реализована следующим образом:
double modf(double value, double *iptr) { #pragma STDC FENV_ACCESS ON int save_round = fegetround(); fesetround(FE_TOWARDZERO); *iptr = std::nearbyint(value); fesetround(save_round); return copysign(isinf(value) ? 0.0 : value - (*iptr), value); }
Пример
#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 %.2f + %.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); // special values f2 = modf(-0.0, &f3); printf("modf(-0) makes %.2f + %.2f\n", f3, f2); f2 = modf(-INFINITY, &f3); printf("modf(-Inf) makes %.2f + %.2f\n", f3, f2); }
Возможный вывод:
Given the number 123.45 or 0x1.edccccccccccdp+6 in hex, modf() makes 123.00 + 0.45 frexp() makes 0.964453 * 2^7 logb()/ilogb() make 1.92891 * 2^6 modf(-0) makes -0.00 + -0.00 modf(-Inf) makes -INF + -0.00
Ссылки
- Стандарт C23 (ISO/IEC 9899:2024):
-
- 7.12.6.12 Функции modf (стр.: TBD)
-
- F.10.3.12 Функции modf (стр.: TBD)
- Стандарт C17 (ISO/IEC 9899:2018):
-
- 7.12.6.12 Функции modf (стр.: TBD)
-
- F.10.3.12 Функции modf (стр.: TBD)
- Стандарт C11 (ISO/IEC 9899:2011):
-
- 7.12.6.12 Функции modf (стр. 246-247)
-
- F.10.3.12 Функции modf (стр. 523)
- Стандарт C99 (ISO/IEC 9899:1999):
-
- 7.12.6.12 Функции modf (стр. 227)
-
- F.9.3.12 Функции modf (стр. 460)
- Стандарт C89/C90 (ISO/IEC 9899:1990):
-
- 4.5.4.6 Функция modf
Смотрите также
|
(C99)
(C99)
(C99)
|
округляет до ближайшего целого числа, не превышающего по модулю заданное значение
(функция) |
|
C++ documentation
для
modf
|
|