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