WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

ldexp — C23-Mathematikfunktion

`ldexp(x, exp)` aus `<math.h>` liefert `x * 2^exp`; `ldexpf` und `ldexpl` bedienen `float` und `long double`. Die Skalierung erfolgt somit unabhängig von `FLT_RADIX` mit einer ganzzahligen Zweierpotenz.

Version: C23

Syntax

double ldexp(double x, int exp);

ldexp(x, exp) aus <math.h> liefert x * 2^exp; ldexpf und ldexpl bedienen float und long double. Die Skalierung erfolgt somit unabhängig von FLT_RADIX mit einer ganzzahligen Zweierpotenz.

Das Beispiel ruft ldexp(0.75, 3) und ldexp(-0.5, 2) auf. 6.0 -2.0 zeigt die Skalierung mit 2^3 und 2^2, ohne die Potenzen selbst zu bilden.

Über- oder unterläuft ein endliches Ergebnis, tritt gemäß math_errhandling ein Bereichsfehler auf; errno allein genügt nicht zwingend. Annex F bewahrt das Vorzeichen von Null, liefert für unendliches x Unendlichkeit und propagiert NaN. exp hat Typ int, daher muss auch die Umwandlung eines breiteren Exponenten vorher geprüft werden.

Beispiele

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

int main(void) {
    printf("%.1f %.1f\n", ldexp(0.75, 3), ldexp(-0.5, 2));
    return 0;
}

Ergebnis

6.0 -2.0

Das Beispiel ruft `ldexp(0.75, 3)` und `ldexp(-0.5, 2)` auf. `6.0 -2.0` zeigt die Skalierung mit `2^3` und `2^2`, ohne die Potenzen selbst zu bilden.

Quellen