expm1(3) exponentiell minus 1

Other Alias

expm1f, expm1l

ÜBERSICHT

#include <math.h>


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

Linken Sie mit der Option -lm.

Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

expm1():

_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    || _XOPEN_SOURCE >= 500
    || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
    || /* Glibc-Versionen <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

expm1f(), expm1l():
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
    || /* Glibc-Versionen <= 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 zulässige 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 mathematischer Funktionen erkennen.

Die folgenden Fehler können auftreten:

Bereichsfehler, Überlauf
errno wird auf ERANGE (aber siehe FEHLER) gesetzt. Es wird eine Fließkomma-Überlauf-Ausnahme (FE_OVERFLOW) ausgelöst.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
SchnittstelleAttributWert
expm1(), expm1f(), expm1l() Multithread-FähigkeitMT-Safe

KONFORM ZU

C99, POSIX.1-2001, POSIX.1-2008.

FEHLER

Für einige große, negative x-Werte (bei denen das Ergebnis der Funktion -1 erreicht) löst expm1() fälschlicherweise eine Fließkomma-Unterlauf-Ausnahme aus.

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

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

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 4.06 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Markus Schmitt <[email protected]> und Chris Leick <[email protected]> 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 <[email protected]>.