log

Section: C Library Functions (3)
Updated: 5 février 2023
Index Return to Main Contents

NOM

log, logf, logl - Fonction logarithme népérien

BIBLIOTHÈQUE

Bibliothèque de math (libm, -lm)

SYNOPSIS

#include <math.h>

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

Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :

logf(), logl() :

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
        || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

Ces fonctions renvoient le logarithme népérien de x.

VALEUR RENVOYÉE

En cas de réussite, ces fonctions renvoient le logarithme népérien de x.

Si x n’est pas un nombre, un NaN est renvoyé.

Si x vaut 1, le résultat est +0.

Si x est l’infini positif, l’infini positif est renvoyé.

Si x est zéro, 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 NaN est renvoyé.

ERREURS

Voir math_error(7) pour savoir comment déterminer si une erreur s'est produite lors de l'appel d'une de ces fonctions.

Les erreurs suivantes peuvent se produire :

Erreur de domaine : x est négatif: errno prend la valeur EDOM. Une exception de virgule flottante non valable (FE_INVALID) est levée.
Erreur de pôle : x est zéro: errno prend la valeur ERANGE. Une exception de division par zéro de virgule flottante (FE_DIVBYZERO) est levée.

ATTRIBUTS

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

Interface	Attribut	Valeur
log(), logf(), logl()	Sécurité des threads	MT-Safe

STANDARDS

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

La variante renvoyant double est également conforme à SVr4, 4.3BSD.

BOGUES

Dans la glibc 2.5 et les versions antérieures, log() pour un NaN produit à tort une exception de virgule flottante incorrecte (FE_INVALID).

VOIR AUSSI

cbrt(3), clog(3), log10(3), log1p(3), log2(3), sqrt(3)

TRADUCTION

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Cédric Boutillier <cedric.boutillier@gmail.com>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à

This document was created by man2html, using the manual pages.
Time: 19:43:08 GMT, May 22, 2024