std:: log10, std:: log10f, std:: log10l
|
Definido en el encabezado
<cmath>
|
||
| (1) | ||
|
float
log10
(
float
num
)
;
double
log10
(
double
num
)
;
|
(hasta C++23) | |
|
/*floating-point-type*/
log10 ( /*floating-point-type*/ num ) ; |
(desde C++23)
(constexpr desde C++26) |
|
|
float
log10f
(
float
num
)
;
|
(2) |
(desde C++11)
(constexpr desde C++26) |
|
long
double
log10l
(
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 log10 ( Integer num ) ; |
(A) | (constexpr desde C++26) |
std::log10
para todos los tipos de punto flotante sin calificación cv como el tipo del parámetro.
(desde C++23)
|
S)
La sobrecarga SIMD realiza un
std::log10
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 común (base- 10 ) de num ( log 10 (num) o lg(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 :: log10 ( num ) tenga el mismo efecto que std :: log10 ( static_cast < double > ( num ) ) .
Ejemplo
#include <cerrno> #include <cfenv> #include <cmath> #include <cstring> #include <iostream> // #pragma STDC FENV_ACCESS ON int main() { std::cout << "log10(1000) = " << std::log10(1000) << '\n' << "log10(0.001) = " << std::log10(0.001) << '\n' << "base-5 logarithm of 125 = " << std::log10(125) / std::log10(5) << '\n'; // special values std::cout << "log10(1) = " << std::log10(1) << '\n' << "log10(+Inf) = " << std::log10(INFINITY) << '\n'; // error handling errno = 0; std::feclearexcept(FE_ALL_EXCEPT); std::cout << "log10(0) = " << std::log10(0) << '\n'; if (errno == ERANGE) std::cout << " errno == ERANGE: " << std::strerror(errno) << '\n'; if (std::fetestexcept(FE_DIVBYZERO)) std::cout << " FE_DIVBYZERO raised\n"; }
Salida posible:
log10(1000) = 3
log10(0.001) = -3
base-5 logarithm of 125 = 3
log10(1) = 0
log10(+Inf) = inf
log10(0) = -inf
errno == ERANGE: Numerical result out of range
FE_DIVBYZERO raised
Véase también
|
(C++11)
(C++11)
|
calcula el logaritmo natural (base
e
) (
ln(x)
)
(función) |
|
(C++11)
(C++11)
(C++11)
|
logaritmo base
2
del número dado (
log
2
(x)
)
(función) |
|
(C++11)
(C++11)
(C++11)
|
logaritmo natural (base
e
) de
1
más el número dado (
ln(1+x)
)
(función) |
|
logaritmo común complejo con cortes de rama a lo largo del eje real negativo
(plantilla de función) |
|
|
aplica la función
std::log10
a cada elemento del valarray
(plantilla de función) |
|
|
Documentación C
para
log10
|
|