expm1(3)

BEZEICHNUNG
expm1, expm1f, expm1l - exponentiell minus 1

BIBLIOTHEK
Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT
#include <math.h>

double expm1(double x);
float expm1f(float x);
long double expm1l(long double x);

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

expm1():
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    || _XOPEN_SOURCE >= 500
    || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
    || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

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

BESCHREIBUNG
Der Rückgabewert dieser Funktionen entspricht

    exp(x) - 1

Das Ergebnis wird auf eine Art berechnet, die sogar dann genau ist, wenn x nahe Null liegt – einem Fall, in dem exp(x) - 1 aufgrund einer Subtraktion von zwei beinahe gleichen Zahlen ungenau wäre.

RÜCKGABEWERT
Bei Erfolg geben diese Funktionen exp(x) - 1 zurück.

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

Falls x gleich +0 (-0) ist, wird +0 (-0) zurückgegeben.

Falls x plus unendlich ist, wird plus unendlich zurückgegeben.

Falls x minus unendlich ist, wird -1 zurückgegeben.

Wenn das Ergebnis überläuft, erscheint ein Bereichsfehler und die Funktionen geben -HUGE_VAL, -HUGE_VALF beziehungsweise -HUGE_VALL zurück.

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 (aber siehe FEHLER). Es wird ein Fließkomma-Ausnahmefehler »Überlauf« (FE_OVERFLOW) ausgelöst.

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

STANDARDS
C11, POSIX.1-2008.

GESCHICHTE
C99, POSIX.1-2001. BSD.

FEHLER
Vor Glibc 2.17 löste expm1() auf bestimmten Architekturen (z.B. X86, aber nicht X86-64) einen falschen Fließkommaunterlauf für bestimmte große negative x-Werte aus (bei denen das Funktionsergebnis sich -1 annähert).

Vor ungefähr Glibc 2.11 löste expm1() für einige große, positive x-Werte zusätzlich zur Überlauf-Ausnahme fälschlicherweise eine Fließkomma-ungültig-Ausnahme aus und gab anstelle von plus unendlich für einige große positive x-Werte ein NaN zurück.

Vor Glibc 2.11 setzte die Glibc-Implementierung errno nicht auf ERANGE, wenn ein Bereichsfehler auftrat.

SIEHE AUCH
exp(3), log(3), log1p(3)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Markus Schmitt <fw@math.uni-sb.de>, Chris Leick <c.leick@vollbio.de> und 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).