std::log2, std::log2f, std::log2l
De cppreference.com
<tbody>
</tbody>
| Definido en el archivo de encabezado <cmath>
|
||
float log2 ( float arg ); float log2f( float arg ); |
(1) | (desde C++11) |
double log2 ( double arg ); |
(2) | (desde C++11) |
long double log2 ( long double arg ); long double log2l( long double arg ); |
(3) | (desde C++11) |
double log2 ( TipoEntero arg ); |
(4) | (desde C++11) |
1-3) Calcula el logaritmo binario (base 2) de
arg.4) Un conjunto de sobrecargas o una plantilla de función que acepta un argumento de cualquier tipo entero. Equivalente a (2) (el argumento se convierte a
double).Parámetros
| arg | - | Valor de un tipo de punto flotante o un tipo entero. |
Valor de retorno
Si no se producen errores, se devuelve el logaritmo binario (base 2) de arg (log
2(arg) o lb(arg)).
Si se produce un error de dominio, se devuelve un valor definido por la implementación (NaN donde se dé apoyo).
Si se produce un error de polo, se devuelve HUGE_VAL, -HUGE_VALF, o -HUGE_VALL.
Manejo de errores
Los errores se informan como se especifica en math_errhandling.
Se produce un error de dominio si arg es menor que cero.
Se puede producir un error de polo si arg es cero.
Si la implementación admite la aritmética de punto flotante IEEE (IEC 60559):
- Si el argumento es +0 o -0, se devuelve -∞ y se genera FE_DIVBYZERO.
- Si el argumento es 1, se devuelve +0.
- Si el argumento es negativo, se devuelve NaN y se genera FE_INVALID.
- Si el argumento es +∞, se devuelve +∞.
- Si el argumento es NaN, se devuelve NaN.
Notas
Para el número entero arg, el logaritmo binario se puede interpretar como el índice basado en cero del bit 1 más significativo en la entrada.
Ejemplo
Ejecuta este código
#include <iostream>
#include <cmath>
#include <cerrno>
#include <cstring>
#include <cfenv>
// #pragma STDC FENV_ACCESS ON
int main()
{
std::cout << "log2(65536) = " << std::log2(65536) << '\n'
<< "log2(0.125) = " << std::log2(0.125) << '\n'
<< "log2(0x020f) = " << std::log2(0x020f)
<< " (el bit establecido más alto está en la posición 9)\n"
<< "logaritmo base 5 de 125 = " << std::log2(125)/std::log2(5) << '\n';
// valores especiales
std::cout << "log2(1) = " << std::log2(1) << '\n'
<< "log2(+Inf) = " << std::log2(INFINITY) << '\n';
// manejo de errores
errno = 0;
std::feclearexcept(FE_ALL_EXCEPT);
std::cout << "log2(0) = " << std::log2(0) << '\n';
if (errno == ERANGE)
std::cout << " errno == ERANGE: " << std::strerror(errno) << '\n';
if (std::fetestexcept(FE_DIVBYZERO))
std::cout << " Se generó FE_DIVBYZERO\n";
}
Posible salida:
log2(65536) = 16
log2(0.125) = -3
log2(0x020f) = 9.04166 (el bit establecido más alto está en la posición 9)
logaritmo base 5 de 125 = 3
log2(1) = 0
log2(+Inf) = inf
log2(0) = -inf
errno == ERANGE: Resultado numérico fuera de rango
Se generó FE_DIVBYZERO
Véase también
(C++11)(C++11) |
Calcula el logaritmo natural (base e) (ln(x)) (función) |
(C++11)(C++11) |
Calcula el logaritmo común (base 10) (log10(x)) (función) |
(C++11)(C++11)(C++11) |
Logaritmo natural (a base e) de 1 más el número dado (ln(1+x)) (función) |
(C++11)(C++11)(C++11) |
Devuelve 2 elevado a la potencia dada (2x) (función) |
Documentación de C para log2
| |