frexp, frexpf, frexpl

参数

返回值

若 arg 为零，则返回零并存储零于 *exp。

否则（若 arg 非零），若不出现错误，则返回范围 (-1;-0.5], [0.5; 1) 中的值 x，并存储整数值为 *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("给定数值 %.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

引用

参阅