BEZEICHNUNG

       log, logf, logl - natürliche Logarithmusfunktion

BIBLIOTHEK

       Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT

       #include <math.h>

       double log(double x);
       float logf(float x);
       long double logl(long double x);

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

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

BESCHREIBUNG

       Diese Funktionen liefern den natürlichen Logarithmus von x zurück.

RÜCKGABEWERT

       Im Erfolgsfall liefern diese Funktionen den natürlichen Logarithmus von x zurück.

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

       Falls x 1 ist, dann ist das Ergebnis +0.

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

       Falls  x Null ist, tritt ein Polfehler auf und die Funktionen geben -HUGE_VAL, -HUGE_VALF beziehungsweise
       -HUGE_VALL zurück.

       Falls x negativ (einschließlich negativ unendlich) ist, dann tritt ein Wertebereichsfehler  auf  und  ein
       NaN (keine Zahl) wird zurückgeliefert.

FEHLER

       In math_error(7) erfahren Sie, wie Sie Fehler bei der Ausführung dieser Funktionen erkennen.

       Die folgenden Fehler können auftreten:

       Wertebereichsfehler: x ist negativ
              errno  wird  auf  EDOM gesetzt. Es wird der Fließkomma-Ausnahmefehler »unzulässige Fließkommazahl«
              (FE_INVALID) ausgelöst.

       Polfehler: x ist Null
              errno wird auf ERANGE  gesetzt.  Es  wird  ein  Fließkomma-Ausnahmefehler  »Division  durch  Null«
              (FE_DIVBYZERO) ausgelöst.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌───────────────────────────────────────────────────────────────────┬───────────────────────┬───────────┐
       │ Schnittstelle                                                     │ Attribut              │ Wert      │
       ├───────────────────────────────────────────────────────────────────┼───────────────────────┼───────────┤
       │ log(), logf(), logl()                                             │ Multithread-Fähigkeit │ MT-Sicher │
       └───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘

STANDARDS

       C11, POSIX.1-2008.

GESCHICHTE

       C99, POSIX.1-2001.

       Die Variante, die double zurückgibt, ist außerdem konform zu SVr4, 4.3BSD, C89.

FEHLER

       In  Glibc  2.5  und  älter  führte  der  Aufruf  von  log()  mit  einer  NaN zu einer unechten ungültigen
       Fließkomma-Ausnahme (FE_INVALID).

SIEHE AUCH

       cbrt(3), clog(3), log10(3), log1p(3), log2(3), sqrt(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.

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