ldexp(3)

BEZEICHNUNG
ldexp, ldexpf, ldexpl - Fließkommazahl mit einer ganzzahligen Zweierpotenz multiplizieren

BIBLIOTHEK
Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT
#include <math.h>

double ldexp(double x, int e);
float ldexpf(float x, int e);
long double ldexpl(long double x, int e);

    Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

ldexpf(), ldexpl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
        || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG
Diese Funktionen geben das Ergebnis der Multiplikation einer Fließkommazahl x mit 2 hoch e zurück.

RÜCKGABEWERT
Bei Erfolg geben diese Funktionen x * (2^e) zurück.

Falls e Null ist, wird x zurückgegeben.

Falls x keine Zahl (»NaN«) ist, wird »NaN« zurückgegeben.

Falls x positiv unendlich (negativ unendlich) ist, wird positiv unendlich (negativ unendlich) zurückgegeben.

Falls das Ergebnis unterläuft, tritt ein Bereichsfehler auf und es wird Null zurückgegeben.

Falls das Ergebnis überläuft, tritt ein Bereichsfehler auf und die Funktionen geben HUGE_VAL, HUGE_VALF beziehungsweise HUGE_VALL zurück, wobei das Vorzeichen identisch zu x ist.

FEHLER
In math_error(7) erfahren Sie, wie Sie Fehler bei der Ausführung dieser Funktionen erkennen.

Die folgenden Fehler können auftreten:

Bereichsfehler, Überlauf
    errno wird auf ERANGE gesetzt. Es wird ein Fließkomma-Ausnahmefehler »Überlauf« (FE_OVERFLOW) ausgelöst.

Bereichsfehler, Unterlauf
    errno wird auf ERANGE gesetzt. Es wird der Fließkomma-Ausnahmefehler »Unterlauf« (FE_UNDERFLOW) ausgelöst.

ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
Schnittstelle | Attribut | Wert
ldexp(), ldexpf(), ldexpl() | Multithread-Fähigkeit | MT-Sicher

STANDARDS
C11, POSIX.1-2008.

GESCHICHTE
C99, POSIX.1-2001.

Die Variante, die double zurückgibt, ist außerdem konform zu SVr4, 4.3BSD, C89.

SIEHE AUCH
frexp(3), modf(3), scalbln(3)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Markus Schmitt <fw@math.uni-sb.de> und Chris Leick <c.leick@vollbio.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.