NOM
log, logf, logl - Fonction logarithme népérien
SYNOPSIS
#include <math.h>
double log(double x);
float logf(float x);
long double logl(long double x);
Effectuez l’édition des liens avec l’option -lm.
Exigences de macros de test de fonctionnalités pour la glibc (voir
feature_test_macros(7)) :
logf(), logl() : _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE>= 600 ||
_ISOC99_SOURCE ; ou cc -std=c99
La fonction log() renvoie le logarithme népérien (ou logarithme
naturel) de x, noté traditionnellement ln en français.
VALEUR RENVOYÉE
En cas de réussite, ces fonctions renvoient le logarithme népérien (ou
logarithme naturel) de x.
Si x est un NaN, la valeur renvoyée et un NaN.
Si x vaut 1, le résultat est +0.
Si x est une valeur infinie positive, une valeur positive infinie est
renvoyée.
Si x est nul, une erreur de pôle se produit et les fonctions renvoient
-HUGE_VAL, -HUGE_VALF ou -HUGE_VALL, respectivement.
Si x est négatif (l’infini négatif compris), alors une erreur de
domaine se produit et un NaN (« Not a Number » : pas un nombre) est
renvoyé.
ERREURS
Consultez math_error(7) pour savoir comment déterminer qu’ une erreur
est survenue lors de l’appel de ces fonctions.
Les erreurs suivantes peuvent se produire :
Erreur de domaine : x est négatif
errno prend la valeur EDOM. Une exception indiquant une virgule
flottante incorrecte (FE_INVALID) est levée.
Erreur de pôle : x est nul
errno prend la valeur ERANGE. Une exception de la virgule
flottante de division par zéro (FE_DIVBYZERO) est levée.
CONFORMITÉ
C99, POSIX.1-2001. La variante renvoyant un double est également
conforme à SVr4, BSD 4.3 et C89.
BOGUES
Dans la glibc 2.5 et les version antérieure, log() produisait à tord
pour un NaN une exception du type virgule flottante incorrecte
(FE_INVALID).
VOIR AUSSI
cbrt(3), clog(3), log1p(3), sqrt(3)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».
10 août 2008 LOG(3)