table of contents
LOG(3) | Linux-Programmierhandbuch | LOG(3) |
BEZEICHNUNG¶
log, logf, logl - natürliche Logarithmusfunktion
ÜBERSICHT¶
#include <math.h>
double log(double x); float logf(float x); long double logl(long double x);
Linken Sie mit der Option -lm.
Mit Glibc erforderliche Feature-Test-Makros (siehe
feature_test_macros(7)):
logf(), logl():
|| /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc-Versionen <= 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 |
KONFORM ZU¶
C99, POSIX.1-2001, POSIX.1-2008.
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¶
KOLOPHON¶
Diese Seite ist Teil der Veröffentlichung 4.16 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 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.
15. September 2017 |