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 zulässige 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 Pol-Fehler 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-Safe │
       └───────────────────────────────────────────────────────┴───────────────────────┴─────────┘

STANDARDS

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

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

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