Loading

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)