scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl

Paramètres

Valeur de retour

Si aucune erreur ne se produit, arg multiplié par FLT_RADIX à la puissance de exp ( arg×FLT_RADIX exp
) est retourné.

Si une erreur de plage due à un dépassement de capacité se produit, ± HUGE_VAL , ±HUGE_VALF , ou ±HUGE_VALL est renvoyé.

Si une erreur de plage due à un dépassement inférieur se produit, le résultat correct (après arrondi) est retourné.

Gestion des erreurs

Les erreurs sont signalées comme spécifié dans math_errhandling .

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

• Sauf en cas d'erreur de plage, FE_INEXACT n'est jamais déclenché (le résultat est exact).
• Sauf en cas d'erreur de plage, le mode d'arrondi actuel est ignoré.
• Si arg est ±0, il est retourné, non modifié.
• Si arg est ±∞, il est retourné, non modifié.
• Si exp est 0, alors arg est retourné, non modifié.
• Si arg est NaN, NaN est retourné.

Notes

Sur les systèmes binaires (où FLT_RADIX est 2 ), scalbn est équivalent à ldexp .

Bien que scalbn et scalbln soient conçus pour effectuer l'opération efficacement, dans de nombreuses implémentations ils sont moins efficaces qu'une multiplication ou division par une puissance de deux utilisant les opérateurs arithmétiques.

La fonction scalbln est fournie car le facteur nécessaire pour passer de la plus petite valeur positive en virgule flottante à la plus grande valeur finie peut être supérieur à 32767 , la valeur garantie par la norme pour INT_MAX . En particulier, pour le long double 80 bits, le facteur est 32828 .

Exemple

#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

Références

Voir aussi