log1p, log1pf, log1pl

Calcula o logaritmo natural de 1 mais o valor especificado.

Sintaxe

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

Parâmetros

x
O argumento de ponto flutuante.

Valor retornado

Se for bem-sucedido, retorna o log natural (base-e) de (x + 1).

Caso contrário, pode retornar um dos seguintes valores:

Entrada	Resultado	Exceção SEH	errno
+INF	+INF
Desnormalizado	Igual à entrada	UNDERFLOW
±0	Igual à entrada
-1	-INF	DIVBYZERO	ERANGE
< -1	NaN	INVALID	EDOM
-INF	NaN	INVALID	EDOM
±SNaN	Igual à entrada	INVALID
±QNaN, indefinido	Igual à entrada

O errno valor será definido como ERANGE se x = -1. O errno valor é definido como EDOM se x< -1.

Comentários

As log1p funções podem ser mais precisas do que usar log(x + 1) quando x está próximo de 0.

Como C++ permite sobrecargas, é possível chamar sobrecargas de log1p que usam e retornam tipos float e long double. Em um programa C, a menos que esteja usando a macro <tgmath.h> para chamar essa função, log1p sempre recebe e retorna um double.

Se você usar a <tgmath.h> log1p() macro, o tipo do argumento determinará qual versão da função será selecionada. Confira Matemática do tipo genérico para obter detalhes.

Onde x é um número natural, esta função retorna o logaritmo de base e de x + 1.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Função	Cabeçalho C	Cabeçalho C++
log1p, log1pf, log1pl	<math.h>	<cmath>
Macro log1p	<tgmath.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Referência alfabética de função
log2, log2f, log2l
log, logf, log10, log10f