log, logf, logl

Parámetros

Valor de retorno

Si no ocurren errores, se devuelve el logaritmo natural (base- e ) de arg ( ln(arg) o log e (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 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.

Ejemplo

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

log(1) = 0.000000
base-5 logarithm of 125 = 3.000000
log(1) = 0.000000
log(+Inf) = inf
log(0) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

Referencias

Véase también