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

Linux man-pages 6.9.1                              2. Mai 2024                                          expm1(3)