Share via


log1p, log1pf, log1pl

Calcule le logarithme népérien de 1 plus la valeur spécifiée.

Syntaxe

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

#define log1p(X) // Requires C11 or higher

float log1p(float x); //C++ only
long double log1p(long double x); //C++ only

Paramètres

x
Argument à virgule flottante.

Valeur retournée

Si elle réussit, retourne le journal naturel (base-e) de (x + 1).

Sinon, peut retourner l’une des valeurs suivantes :

Entrée Résultat Exception SEH errno
+INF +INF
Nombres dénormalisés Comme dans l’entrée UNDERFLOW
±0 Comme dans l’entrée
-1 -INF DIVBYZERO ERANGE
< -1 NaN INVALID EDOM
-INF NaN INVALID EDOM
±SNaN Comme dans l’entrée INVALID
±QNaN, indéfini Comme dans l’entrée

errno prend la valeur ERANGE si x est égal à -1. La errno valeur est définie EDOM sur - x< 1.

Notes

Les log1p fonctions peuvent être plus précises que l’utilisation log(x + 1) d’une valeur x proche de 0.

C++ autorisant la surcharge, vous pouvez appeler des surcharges de log1p qui acceptent et retournent des types float et long double. Dans un programme C, sauf si vous utilisez la <macro tgmath.h> pour appeler cette fonction, log1p prend toujours et retourne un double.

Si vous utilisez la <tgmath.h>log1p() macro, le type de l’argument détermine la version de la fonction sélectionnée. Pour plus d’informations, consultez les mathématiques génériques de type.

x est un nombre naturel, cette fonction retourne le logarithme de base de x + 1.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Fonction En-tête C En-tête C++
log1p, log1pf, log1pl <math.h> <cmath>
Macro log1p <tgmath.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

Informations de référence sur les fonctions alphabétiques
log2, log2f, log2l
log, logf, log10, log10f