frexp, frexpf, frexpl

Paramètres

Valeur de retour

Si arg est nul, renvoie zéro et stocke zéro dans *exp .

Sinon (si arg n'est pas zéro), si aucune erreur ne se produit, retourne la valeur x dans l'intervalle (-1;-0.5], [0.5; 1) et stocke une valeur entière dans * exp telle que x×2 (*exp)
=arg .

Si la valeur à stocker dans *exp est en dehors de la plage de int , le comportement n'est pas spécifié.

Si arg n'est pas un nombre à virgule flottante, le comportement est non spécifié.

Gestion des erreurs

Cette fonction n'est pas sujette aux erreurs spécifiées dans math_errhandling .

Si l'implémentation prend en charge l'arithmétique à virgule flottante IEEE (IEC 60559),

• Si arg est ±0, il est retourné, non modifié, et 0 est stocké dans * exp .
• Si arg est ±∞, il est retourné, et une valeur non spécifiée est stockée dans * exp .
• Si arg est NaN, NaN est retourné, et une valeur non spécifiée est stockée dans * exp .
• Aucune exception de virgule flottante n'est levée.
• Si FLT_RADIX est 2 (ou une puissance de 2), la valeur retournée est exacte, le mode d'arrondi actuel est ignoré.

Notes

Dans un système binaire (où FLT_RADIX est 2 ), frexp peut être implémenté comme suit

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

` et contient des termes spécifiques au C++ qui doivent être préservés. Seul le texte environnant (s'il y en avait) aurait été traduit en français.

La fonction frexp , ainsi que son dual, ldexp , peut être utilisée pour manipuler la représentation d'un nombre à virgule flottante sans manipulations directes de bits.

Exemple

#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

Références

Voir aussi