log1p
, , log1pf
, log1pl
Calcula el logaritmo natural de 1 más el valor especificado.
Sintaxis
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
El argumento de punto flotante.
Valor devuelto
Si se ejecuta correctamente, devuelve el registro natural (base-e) de (x
+ 1).
De lo contrario, es posible que devuelva uno de los siguientes valores:
Entrada | Resultado | Excepción SEH | errno |
---|---|---|---|
+INF | +INF | ||
Desnormalizados | Igual que la entrada | UNDERFLOW |
|
±0 | Igual que la entrada | ||
-1 | -INF | DIVBYZERO |
ERANGE |
< -1 | NaN | INVALID |
EDOM |
-INF | NaN | INVALID |
EDOM |
±SNaN | Igual que la entrada | INVALID |
|
±QNaN, indefinida | Igual que la entrada |
El valor errno
se establece en ERANGE si x
= -1. El errno
valor se establece en EDOM
si x
< -1.
Comentarios
Las log1p
funciones pueden ser más precisas que usar log(x + 1)
cuando x
está cerca de 0.
Como C++ permite las sobrecargas, puede llamar a las sobrecargas de log1p
que toman y devuelven los tipos float
y long double
. En un programa de C, a menos que use la macro de <tgmath.h> para llamar a esta función, log1p
siempre toma y devuelve un double
.
Si usa la <tgmath.h>
log1p()
macro, el tipo del argumento determina qué versión de la función está seleccionada. Consulte Matemáticas de tipo genérico para obtener más información.
Donde x
es un número natural, esta función devuelve el logaritmo e base de x
+ 1.
De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.
Requisitos
Función | Encabezado C | Encabezado C++ |
---|---|---|
log1p , , log1pf , log1pl |
<math.h> |
<cmath> |
log1p Macro |
<tgmath.h> |
Para obtener más información sobre compatibilidad, consulte Compatibilidad.
Consulte también
referencia de función alfabética
log2
, , log2f
, log2l
log
, logf
, , log10
, log10f