Udostępnij za pośrednictwem

log1p, , log1pflog1pl

  • Artykuł

Oblicza logarytm naturalny o wartości 1 i określoną wartość.

Składnia

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

Parametry

x
Argument zmiennoprzecinkowa.

Wartość zwracana

W przypadku powodzenia zwraca naturalny (base-e) dziennik (x + 1).

W przeciwnym razie może zwrócić jedną z następujących wartości:

Dane wejściowe Result Wyjątek SEH errno
+INF +INF
Denormale Tak samo jak dane wejściowe UNDERFLOW
±0 Tak samo jak dane wejściowe
-1 -INF DIVBYZERO ERANGE
< -1 NaN INVALID EDOM
-INF NaN INVALID EDOM
±SNaN Tak samo jak dane wejściowe INVALID
±QNaN, nieokreślony Tak samo jak dane wejściowe

Wartość jest ustawiona errno na ERANGE, jeśli x = -1. Wartość jest ustawiona errno na EDOM wartość if x< -1.

Uwagi

Funkcje log1p mogą być bardziej dokładne niż w log(x + 1) przypadku, gdy x wartość jest zbliżona do 0.

Ponieważ język C++ umożliwia przeciążenie, można wywołać przeciążenia tych operacji log1p , które przyjmują i zwracają float i long double typy. W programie języka C, chyba że używasz makra <tgmath.h> do wywołania tej funkcji, log1p zawsze przyjmuje i zwraca wartość double.

Jeśli używasz makra <tgmath.h> log1p() , typ argumentu określa, która wersja funkcji jest zaznaczona. Aby uzyskać szczegółowe informacje, zobacz Typy ogólne matematyczne .

Gdzie x jest liczbą naturalną, ta funkcja zwraca logarytm podstawowy o wartości x + 1.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Function Nagłówek języka C Nagłówek języka C++
log1p, , log1pflog1pl <math.h> <cmath>
log1p Makro <tgmath.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Zobacz też

Odwołanie do funkcji alfabetycznej
log2, , log2flog2l
log, , logf, , log10log10f