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.

Retornar valor

Se 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 if x< -1.

Comentários

As log1p funções podem ser mais precisas do que usar log(x + 1) quando x está perto 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 você esteja usando a <macro tgmath.h> para chamar essa função, log1p sempre usa e retorna um doublearquivo .

Se você usar a macro <tgmath.h>log1p(), 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 x base de + 1.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na 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 de função alfabética
log2, log2f, log2l
log, logf, log10, log10f