log1p(3)

NOM
log1p, log1pf, log1pl - Logarithme de 1 plus x

BIBLIOTHÈQUE
Bibliothèque de math (libm, -lm)

SYNOPSIS
#include <math.h>

double log1p(double x);
float log1pf(float x);
long double log1pl(long double x);

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

log1p():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
        || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

log1pf(), log1pl() :
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
        || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION
Ces fonctions renvoient une valeur équivalente à

    log (1 + x)

Le résultat est calculé d'une manière précise même lorsque x est proche de zéro.

VALEUR RENVOYÉE
En cas de réussite, ces fonctions renvoient le logarithme népérien (ou logarithme naturel) de (1 + x).

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

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

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 compris), 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 inférieur à -1
    errno prend la valeur EDOM (mais consultez la section BOGUES). Une exception indiquant une virgule flottante incorrecte (FE_INVALID) est levée.

Erreur de pôle : x vaut -1
    errno est configuré à la valeur ERANGE (mais consultez la section BOGUES). Une exception de virgule flottante divisée par zéro (FE_DIVBYZERO) est déclenchée.

ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter attributes(7).
Interface | Attribut | Valeur
log1p(), log1pf(), log1pl() | Sécurité des threads | MT-Safe

STANDARDS
C11, POSIX.1-2008.

HISTORIQUE
C99, POSIX.1-2001.

BOGUES
Avant la glibc 2.22, l'implémentation de la glibc ne positionne pas errno à EDOM quand une erreur de domaine se produit.

Avant la glibc 2.22, l'implémentation de la glibc ne définit pas errno à ERANGE lorsqu'une erreur d'intervalle se produit.

VOIR AUSSI
exp(3), expm1(3), log(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 (https://www.gnu.org/licenses/gpl-3.0.html) 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 à debian-l10n-french@lists.debian.org.