ldexp, ldexpf, ldexpl

Parámetros

Valor de retorno

Si no ocurren errores, arg multiplicado por 2 elevado a la potencia de exp ( arg×2 exp
) es retornado.

Si ocurre un error de rango debido a desbordamiento, ±HUGE_VAL , ±HUGE_VALF , o ±HUGE_VALL es devuelto.

Si ocurre un error de rango debido a desbordamiento inferior, se devuelve el resultado correcto (después del redondeo).

Manejo de errores

Los errores se reportan como se especifica en math_errhandling .

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

• A menos que ocurra un error de rango, FE_INEXACT nunca se activa (el resultado es exacto)
• A menos que ocurra un error de rango, se ignora el modo de redondeo actual
• Si arg es ±0, se devuelve sin modificación
• Si arg es ±∞, se devuelve sin modificación
• Si exp es 0, entonces arg se devuelve sin modificación
• Si arg es NaN, se devuelve NaN.

Notas

En sistemas binarios (donde FLT_RADIX es 2 ), ldexp es equivalente a scalbn .

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

En muchas implementaciones, ldexp es menos eficiente que la multiplicación o división por una potencia de dos utilizando operadores aritméticos.

Ejemplo

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("ldexp(7, -4) = %f\n", ldexp(7, -4));
    printf("ldexp(1, -1074) = %g (minimum positive subnormal double)\n",
            ldexp(1, -1074));
    printf("ldexp(nextafter(1,0), 1024) = %g (largest finite double)\n",
            ldexp(nextafter(1,0), 1024));
    // special values
    printf("ldexp(-0, 10) = %f\n", ldexp(-0.0, 10));
    printf("ldexp(-Inf, -1) = %f\n", ldexp(-INFINITY, -1));
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("ldexp(1, 1024) = %f\n", ldexp(1, 1024));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_OVERFLOW))
        puts("    FE_OVERFLOW raised");
}

ldexp(7, -4) = 0.437500
ldexp(1, -1074) = 4.94066e-324 (minimum positive subnormal double)
ldexp(nextafter(1,0), 1024) = 1.79769e+308 (largest finite double)
ldexp(-0, 10) = -0.000000
ldexp(-Inf, -1) = -inf
ldexp(1, 1024) = inf
    errno == ERANGE: Numerical result out of range
    FE_OVERFLOW raised

Referencias

Véase también