Partilhar via

ldexp, ldexpf, ldexpl

  • Artigo

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

Sintaxe

double ldexp(
   double x,
   int exp
);
float ldexpf(
   float x,
   int exp
);
long double ldexpl(
   long double x,
   int exp
);
#define ldexp(X, INT) // Requires C11 or higher

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

Parâmetros

x
Valor de ponto flutuante.

exp
Expoente inteiro.

Valor retornado

As ldexp funções retornam o valor de x * 2exp se forem bem-sucedidas. No estouro, e dependendo do sinal de x, retorna +/- HUGE_VAL; o errno valor é definido como ERANGEldexp .

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

Comentários

Como C++ permite a sobrecarga, você pode chamar sobrecargas de ldexp que usam o tipo float ou long double. Em um programa C, a menos que você esteja usando a <macro tgmath.h> para chamar essa função, ldexp sempre usa a double e an int e retorna um double.

Se você usa a macro <tgmath.h>ldexp(), o tipo do argumento determina 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, confira Estado global no CRT.

Requisitos

Rotina Cabeçalho C Cabeçalho C++
ldexp, ldexpf, ldexpl <math.h> <cmath>
Macro ldexp <tgmath.h>

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

Exemplo

// crt_ldexp.c

#include <math.h>
#include <stdio.h>

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

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

Saída

4.0 times two to the power of 3 is 32.0

Confira também

Suporte matemático e de ponto flutuante
frexp
modf, modff, modfl