Condividi tramite


log1p, log1pf, log1pl

Calcola il logaritmo naturale di 1 più il valore specificato.

Sintassi

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

Parametri

x
Argomento a virgola mobile.

Valore restituito

In caso di esito positivo, restituisce il log naturale (base-e) di (x + 1).

In caso contrario, può restituire uno dei valori seguenti:

Input Risultato Eccezione SEH errno
+INF +INF
Valori denormalizzati Uguale all'input UNDERFLOW
±0 Uguale all'input
-1 -INF DIVBYZERO ERANGE
< -1 NaN INVALID EDOM
-INF NaN INVALID EDOM
±SNaN Uguale all'input INVALID
±QNaN, indefinito Uguale all'input

Il valore di errno è impostato su ERANGE se x = -1. Il errno valore è impostato su EDOM se x< -1.

Osservazioni:

Le log1p funzioni possono essere più accurate rispetto all'uso log(x + 1) quando x è vicino a 0.

Poiché C++ consente l'overload, è possibile chiamare gli overload di log1p che accettano e restituiscono i tipi float e long double. In un programma C, a meno che non si usi la <macro tgmath.h> per chiamare questa funzione, log1p accetta sempre e restituisce un oggetto double.

Se si utilizza la <tgmath.h> log1p() macro, il tipo dell'argomento determina quale versione della funzione è selezionata. Per informazioni dettagliate, vedere La matematica generica dei tipi.

Dove x è un numero naturale, questa funzione restituisce il logaritmo di base e di x + 1.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Funzione Intestazione C Intestazione C++
log1p, log1pf, log1pl <math.h> <cmath>
log1p macro <tgmath.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

Informazioni di riferimento sulle funzioni alfabetiche
log2, log2f, log2l
log, logf, log10log10f