ldexp

Artikel
06/09/2015

Multipliziert eine Gleitkommazahl mit einer ganzzahligen Potenz von zwei.

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

Parameter

x
Gleitkommawert.
exp
Ganzzahlexponent.

Rückgabewert

Bei Erfolg gibt die ldexp-Funktion gibt den Wert x * 2exp zurück. Bei einem Überlauf und abhängig vom Vorzeichen von x gibt ldexp +/– HUGE_VAL zurück. Der errno-Wert wird auf ERANGE gesetzt.

Weitere Informationen über errno und mögliche Fehlerrückgabewerte finden Sie unter errno, _doserrno, _sys_errlist und _sys_nerr.

Hinweise

Da C++ das Überladen zulässt, können Sie Überladungen von ldexp aufrufen, die float oder long double-Typen verwenden. In einem C-Programm verwendet ldexp immer double und int und gibt double zurück.

Anforderungen

Routine	C-Header	C++-Header
ldexp, ldexpf, ldexpl	<math.h>	<cmath>

Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

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