1. NOM

log1p, log1pf, log1pl - Logarithme de 1 plus x

2. SYNOPSIS

 
Sélectionnez
#include <math.h>
double log1p(double x);
float log1pf(float x);
long double log1pl(long double x);

Effectuez l'édition des liens avec l'option -lm.

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

log1p() :
    _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
ou cc -std=c99
log1pf(), log1pl() :
    _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
ou cc -std=c99

3. DESCRIPTION

log1p(x) renvoie la valeur équivalente à

 
Sélectionnez
    log (1 + x)

Elle est calculée de telle manière que la précision est conservée même lorsque x est proche de zéro.

4. VALEUR RENVOYÉE

En cas de réussite, ces fonctions renvoient le logarithme népérien (ou logarithme naturel) de (1 + x). Si x est un NaN, la valeur renvoyée est un NaN. Si x est une valeur infinie positive, une valeur positive infinie est renvoyée. Si x vaut -1, une erreur de pôle se produit et les fonctions renvoient -HUGE_VAL, -HUGE_VALF ou -HUGE_VALL, respectivement. Si x est inférieur à -1 (l'infini négatif inclus), une erreur de domaine se produit et un NaN (« Not a Number » : pas un nombre) est renvoyé.

5. 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 inférieur à -1 Une exception indiquant une virgule flottante incorrecte (FE_INVALID) est levée.
  • Erreur de pôle : x vaut -1 Une exception de virgule flottante de division par zéro (FE_DIVBYZERO) est levée.

Ces fonctions ne positionnent pas errno.

6. CONFORMITÉ

C99, POSIX.1-2001.

7. VOIR AUSSI

exp(3), expm1(3), log(3)

8. COLOPHON

Cette page fait partie de la publication 3.52 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/.

9. TRADUCTION

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».