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.

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 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.