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の場合、変更されずに返され、 * exp に 0 が格納されます。
• 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

参考文献

関連項目