frexp, frexpf, frexpl

Parameter

Rückgabewert

Wenn arg null ist, wird null zurückgegeben und null in *exp gespeichert.

Andernfalls (falls arg nicht null ist), wenn keine Fehler auftreten, gibt den Wert x im Bereich (-1;-0.5], [0.5; 1) zurück und speichert einen ganzzahligen Wert in * exp , sodass x×2 (*exp)
=arg .

Wenn der in *exp zu speichernde Wert außerhalb des Bereichs von int liegt, ist das Verhalten nicht spezifiziert.

Wenn arg keine Gleitkommazahl ist, ist das Verhalten nicht spezifiziert.

Fehlerbehandlung

Diese Funktion unterliegt keinen der in math_errhandling spezifizierten Fehler.

Wenn die Implementierung IEEE-Gleitkommaarithmetik (IEC 60559) unterstützt,

• Wenn arg ±0 ist, wird es unverändert zurückgegeben und 0 in * exp gespeichert.
• Wenn arg ±∞ ist, wird es zurückgegeben und ein nicht spezifizierter Wert in * exp gespeichert.
• Wenn arg NaN ist, wird NaN zurückgegeben und ein nicht spezifizierter Wert in * exp gespeichert.
• Es werden keine Gleitkomma-Ausnahmen ausgelöst.
• Wenn FLT_RADIX 2 (oder eine Zweierpotenz) ist, ist der zurückgegebene Wert exakt und der aktuelle Rundungsmodus wird ignoriert.

Hinweise

In einem binären System (wo FLT_RADIX gleich 2 ist), kann frexp implementiert werden als

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

Die Funktion frexp , zusammen mit ihrem Gegenstück, ldexp , kann verwendet werden, um die Darstellung einer Fließkommazahl zu manipulieren, ohne direkte Bit-Manipulationen durchzuführen.

Beispiel

#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

Referenzen

Siehe auch