log2, log2f, log2l

Parámetros

Valor de retorno

Si no ocurren errores, se devuelve el logaritmo en base 2 de arg ( log 2 (arg) o lb(arg) ).

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 arg es menor que cero.

Puede ocurrir un error de polo si arg es cero.

Si la implementación soporta aritmética de punto flotante IEEE (IEC 60559),

• Si el argumento es ±0, se retorna -∞ y FE_DIVBYZERO se activa.
• Si el argumento es 1, se retorna +0
• Si el argumento es negativo, se retorna NaN y FE_INVALID se activa.
• Si el argumento es +∞, se retorna +∞
• Si el argumento es NaN, se retorna NaN

Notas

Para un entero arg , el logaritmo binario puede interpretarse como el índice basado en cero del bit más significativo en 1 en la entrada.

Ejemplo

#include <stdio.h>
#include <math.h>
#include <float.h>
#include <errno.h>
#include <fenv.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("log2(65536) = %f\n", log2(65536));
    printf("log2(0.125) = %f\n", log2(0.125));
    printf("log2(0x020f) = %f (highest set bit is in position 9)\n", log2(0x020f));
    printf("base-5 logarithm of 125 = %f\n", log2(125)/log2(5));
    // special values
    printf("log2(1) = %f\n", log2(1));
    printf("log2(+Inf) = %f\n", log2(INFINITY));
    //error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("log2(0) = %f\n", log2(0));
    if(errno == ERANGE) perror("    errno == ERANGE");
    if(fetestexcept(FE_DIVBYZERO)) puts("    FE_DIVBYZERO raised");
}

log2(65536) = 16.000000
log2(0.125) = -3.000000
log2(0x020f) = 9.041659 (highest set bit is in position 9)
base-5 logarithm of 125 = 3.000000
log2(1) = 0.000000
log2(+Inf) = inf
log2(0) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

Referencias

Véase también