scalbln(3) | Library Functions Manual | 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);
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¶
Ü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 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.
2. Mai 2024 | Linux man-pages (unveröffentlicht) |