Condividi tramite

scalbn, scalbnf, scalbnl, scalbln, scalblnfscalblnl

  • Articolo

Moltiplica un numero a virgola mobile per una potenza integrale di FLT_RADIX.

Sintassi

double scalbn(
   double x,
   int exp
);
float scalbn(
   float x,
   int exp
);  // C++ only
long double scalbn(
   long double x,
   int exp
);  // C++ only
float scalbnf(
   float x,
   int exp
);
long double scalbnl(
   long double x,
   int exp
);

#define scalbn(X, INT) // Requires C11 or higher

double scalbln(
   double x,
   long exp
);

float scalblnf(
   float x,
   long exp
);
long double scalblnl(
   long double x,
   long exp
);

#define scalbln(X, LONG) // Requires C11 or higher

float scalbln(
   float x,
   long exp
);  // C++ only
long double scalbln(
   long double x,
   long exp
);  // C++ only

Parametri

x
Valore a virgola mobile.

exp
Esponente dell'intero.

Valore restituito

Le funzioni scalbn, se hanno esito positivo, restituiscono il valore di x * FLT_RADIXexp. In caso di overflow (a seconda del segno di x), restituisce +/- HUGE_VAL; il errno valore è impostato su ERANGEscalbn .

Per altre informazioni sui errno possibili valori restituiti dall'errore, vedereerrno , _doserrno_sys_errlist, e _sys_nerr.

Osservazioni:

FLT_RADIX è definito in <float.h> come radix a virgola mobile nativa; nei sistemi binari ha un valore pari a 2 ed scalbn è equivalente a ldexp.

Poiché C++ consente l'overload, è possibile chiamare scalbn e scalbln overload che accettano e restituiscono float tipi o long double . In un programma C, a meno che non si usi la <macro tgmath.h> per chiamare questa funzione, scalbn accetta sempre e double un e restituisce int un doublee e scalbln accetta sempre e double un long e restituisce un oggetto double.

Se si utilizzano le <macro o scalbln tgmath.h>scalbn(), il tipo dell'argomento determina la versione della funzione selezionata. Per informazioni dettagliate, vedere La matematica generica dei tipi.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Funzione Intestazione C Intestazione C++
scalbn, scalbnf, scalbnl, scalbln, scalblnfscalblnl <math.h> <cmath>
scalbn o scalbln macro <tgmath.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

// crt_scalbn.c
// Compile using: cl /W4 crt_scalbn.c
#include <math.h>
#include <stdio.h>

int main( void )
{
   double x = 6.4, y;
   int p = 3;

   y = scalbn( x, p );
   printf( "%2.1f times FLT_RADIX to the power of %d is %2.1f\n", x, p, y );
}

Output

6.4 times FLT_RADIX to the power of 3 is 51.2

Vedi anche

Supporto matematico e a virgola mobile
frexp
ldexp
modf, modff, modfl