frexp, frexpf, frexpl

Parámetros

Valor de retorno

Si arg es cero, retorna cero y almacena cero en *exp .

De lo contrario (si arg no es cero), si no ocurren errores, retorna el valor x en el rango (-1;-0.5], [0.5; 1) y almacena un valor entero en * exp tal que x×2 (*exp)
=arg .

Si el valor a almacenar en *exp está fuera del rango de int , el comportamiento no está especificado.

Si arg no es un número de punto flotante, el comportamiento no está especificado.

Manejo de errores

Esta función no está sujeta a ningún error especificado en math_errhandling .

Si la implementación soporta aritmética de punto flotante IEEE (IEC 60559),

• Si arg es ±0, se devuelve sin modificaciones y se almacena 0 en * exp .
• Si arg es ±∞, se devuelve y se almacena un valor no especificado en * exp .
• Si arg es NaN, se devuelve NaN y se almacena un valor no especificado en * exp .
• No se generan excepciones de punto flotante.
• Si FLT_RADIX es 2 (o una potencia de 2), el valor devuelto es exacto y el modo de redondeo actual se ignora.

Notas

En un sistema binario (donde FLT_RADIX es 2 ), frexp puede implementarse como

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

La función frexp , junto con su dual, ldexp , puede utilizarse para manipular la representación de un número de punto flotante sin manipulaciones directas de bits.

Ejemplo

#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

Referencias

Véase también