scalbln(3)

BEZEICHNUNG
scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl - Fließkommazahlen mit ganzzahligen Potenzen einer Basis multiplizieren

BIBLIOTHEK
Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT
#include <math.h>

double scalbln(double x, long exp);
float scalblnf(float x, long exp);
long double scalblnl(long double x, long exp);

double scalbn(double x, int exp);
float scalbnf(float x, int exp);
long double scalbnl(long double x, int exp);

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

scalbln(), scalblnf(), scalblnl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE

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

BESCHREIBUNG
Diese Funktionen multiplizieren ihr erstes Argument x mit FLT_RADIX (möglicherweise 2) hoch exp, das heißt:

    x * FLT_RADIX ** exp

Die Definition von FLT_RADIX kann mittels der Einbindung von <float.h> erreicht werden.

RÜCKGABEWERT
Bei Erfolg liefern diese Funktionen x * FLT_RADIX ** exp zurück.

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 x gleich +0 (-0) ist, wird +0 (-0) 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.

Falls das Ergebnis unterläuft, tritt ein Bereichsfehler auf und die Funktionen geben Null 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
    Es wird ein Überlauf-Fließkomma-Ausnahmefehler (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
scalbn(), scalbnf(), scalbnl(), scalbln(), scalblnf(), scalblnl() | Multithread-Fähigkeit | MT-Sicher

STANDARDS
C11, POSIX.1-2008.

GESCHICHTE
Glibc 2.1. C99, POSIX.1-2001.

GESCHICHTE
Diese Funktionen unterscheiden sich von den in scalb(3) beschriebenen veralteten Funktionen durch den Typ ihres zweiten Arguments. Die in dieser Seite beschriebenen Funktionen haben ein zweites Argument von ganzzahligem Typ, während die in scalb(3) ein zweites Argument vom Typ double haben.

ANMERKUNGEN
Falls FLT_RADIX zu 2 identisch ist (was normal ist), dann ist scalbn() äquivalent zu ldexp(3).

FEHLER
Vor Glibc 2.20 setzten diese Funktionen errno nicht für Bereichsfehler.

SIEHE AUCH
ldexp(3), scalb(3)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.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).