std:: log, std:: logf, std:: logl
|
Definido en el encabezado
<cmath>
|
||
| (1) | ||
|
float
log
(
float
num
)
;
double
log
(
double
num
)
;
|
(hasta C++23) | |
|
/*floating-point-type*/
log ( /*floating-point-type*/ num ) ; |
(desde C++23)
(constexpr desde C++26) |
|
|
float
logf
(
float
num
)
;
|
(2) |
(desde C++11)
(constexpr desde C++26) |
|
long
double
logl
(
long
double
num
)
;
|
(3) |
(desde C++11)
(constexpr desde C++26) |
|
Sobrecarga SIMD
(desde C++26)
|
||
|
Definido en el encabezado
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (desde C++26) |
|
Sobrecargas adicionales
(desde C++11)
|
||
|
Definido en el encabezado
<cmath>
|
||
|
template
<
class
Integer
>
double log ( Integer num ) ; |
(A) | (constexpr desde C++26) |
std::log
para todos los tipos de punto flotante sin calificación cv como el tipo del parámetro.
(since C++23)
|
S)
La sobrecarga SIMD realiza un
std::log
elemento por elemento en
v_num
.
|
(desde C++26) |
|
A)
Se proporcionan sobrecargas adicionales para todos los tipos enteros, los cuales son tratados como
double
.
|
(since C++11) |
Contenidos |
Parámetros
| num | - | valor de punto flotante o entero |
Valor de retorno
Si no ocurren errores, se devuelve el logaritmo natural (base- e ) de num ( ln(num) o log e (num) ).
Si ocurre un error de dominio, se devuelve un valor definido por la implementación (NaN donde esté soportado).
Si ocurre un error de polo,
-HUGE_VAL
,
-HUGE_VALF
, o
-HUGE_VALL
es devuelto.
Manejo de errores
Los errores se reportan como se especifica en math_errhandling .
Error de dominio ocurre si num es menor que cero.
Puede ocurrir un error de polo si num es cero.
Si la implementación soporta aritmética de punto flotante IEEE (IEC 60559),
- Si el argumento es ±0, se devuelve -∞ y FE_DIVBYZERO se activa.
- Si el argumento es 1, se devuelve +0.
- Si el argumento es negativo, se devuelve NaN y FE_INVALID se activa.
- Si el argumento es +∞, se devuelve +∞.
- Si el argumento es NaN, se devuelve NaN.
Notas
Las sobrecargas adicionales no requieren ser proporcionadas exactamente como (A) . Solo necesitan ser suficientes para garantizar que para su argumento num de tipo entero, std :: log ( num ) tenga el mismo efecto que std :: log ( static_cast < double > ( num ) ) .
Ejemplo
#include <cerrno> #include <cfenv> #include <cmath> #include <cstring> #include <iostream> // #pragma STDC FENV_ACCESS ON int main() { std::cout << "log(1) = " << std::log(1) << '\n' << "logaritmo en base 5 de 125 = " << std::log(125) / std::log(5) << '\n'; // valores especiales std::cout << "log(1) = " << std::log(1) << '\n' << "log(+Inf) = " << std::log(INFINITY) << '\n'; // manejo de errores errno = 0; std::feclearexcept(FE_ALL_EXCEPT); std::cout << "log(0) = " << std::log(0) << '\n'; if (errno == ERANGE) std::cout << " errno == ERANGE: " << std::strerror(errno) << '\n'; if (std::fetestexcept(FE_DIVBYZERO)) std::cout << " FE_DIVBYZERO activada\n"; }
Salida posible:
log(1) = 0
logaritmo en base 5 de 125 = 3
log(1) = 0
log(+Inf) = inf
log(0) = -inf
errno == ERANGE: Resultado numérico fuera de rango
FE_DIVBYZERO activada
Véase también
|
(C++11)
(C++11)
|
calcula el logaritmo común (base
10
) (
log
10
(x)
)
(función) |
|
(C++11)
(C++11)
(C++11)
|
logaritmo en base
2
del número dado (
log
2
(x)
)
(función) |
|
(C++11)
(C++11)
(C++11)
|
logaritmo natural (en base
e
) de
1
más el número dado (
ln(1+x)
)
(función) |
|
(C++11)
(C++11)
|
devuelve
e
elevado a la potencia dada (
e
x
)
(función) |
|
logaritmo natural complejo con cortes de rama a lo largo del eje real negativo
(plantilla de función) |
|
|
aplica la función
std::log
a cada elemento del valarray
(plantilla de función) |
|
|
Documentación C
para
log
|
|