scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl

Multiplica um número de ponto flutuante por uma potência integral de FLT_RADIX.

Sintaxe

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

Parâmetros

x
Valor de ponto flutuante.

exp
Expoente inteiro.

Retornar valor

As funções scalbn retornam o valor de x * FLT_RADIX^exp quando bem-sucedidas. No estouro (dependendo do sinal de x), retorna +/- HUGE_VAL; o errno valor é definido como ERANGEscalbn .

Para obter mais informações sobre errno e possíveis valores de retorno de erro, consulteerrno , , _doserrno_sys_errliste _sys_nerr.

Comentários

FLT_RADIXé definido em float.h> como o radix de ponto flutuante nativo, em <sistemas binários, tem um valor de 2, e scalbn é equivalente a ldexp.

Como o C++ permite sobrecarga, você pode chamar scalbn e sobrecarregar que levam e scalbln retornam float ou long double tipos. Em um programa C, a menos que você esteja usando a macro tgmath.h para chamar essa função, sempre leva um e um e retorna um , scalbn e sempre leva um e um e scalbln retorna um doubleintdoubledoubledoublelong .><

Se você usar as macros <tgmath.h>scalbn() ou scalbln, o tipo do argumento determinará qual versão da função será selecionada. Confira Matemática do tipo genérico para obter detalhes.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Requisitos

Função	Cabeçalho C	Cabeçalho C++
scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl	<matemática.h>	<cmath>
scalbn ou scalbln macro	<tgmath.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// 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 );
}

Saída

6.4 times FLT_RADIX to the power of 3 is 51.2

Confira também

Suporte a matemática e ponto flutuante
frexp
ldexp
modf, modff, modfl