scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl

Parámetros

Valor de retorno

Si no ocurren errores, arg multiplicado por FLT_RADIX elevado a la potencia de exp ( arg×FLT_RADIX 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 modificaciones.
• Si arg es ±∞, se devuelve sin modificaciones.
• Si exp es 0, entonces se devuelve arg sin modificaciones.
• Si arg es NaN, se devuelve NaN.

Notas

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

Aunque scalbn y scalbln están especificados para realizar la operación de manera eficiente, en muchas implementaciones son menos eficientes que la multiplicación o división por una potencia de dos utilizando operadores aritméticos.

La función scalbln se proporciona porque el factor requerido para escalar desde el valor de punto flotante positivo más pequeño hasta el finito más grande puede ser mayor que 32767 , el INT_MAX garantizado por el estándar. En particular, para el long double de 80 bits, el factor es 32828 .

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("scalbn(7, -4) = %f\n", scalbn(7, -4));
    printf("scalbn(1, -1074) = %g (minimum positive subnormal double)\n",
            scalbn(1, -1074));
    printf("scalbn(nextafter(1,0), 1024) = %g (largest finite double)\n",
            scalbn(nextafter(1,0), 1024));
    // special values
    printf("scalbn(-0, 10) = %f\n", scalbn(-0.0, 10));
    printf("scalbn(-Inf, -1) = %f\n", scalbn(-INFINITY, -1));
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("scalbn(1, 1024) = %f\n", scalbn(1, 1024));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_OVERFLOW))
        puts("    FE_OVERFLOW raised");
}

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

Referencias

Véase también