pow, powf, powl

Parámetros

Valor de retorno

Si no ocurren errores, base elevado a la potencia de exponent ( base exponent
) es devuelto.

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 o un error de rango debido a desbordamiento, ± HUGE_VAL , ±HUGE_VALF , o ±HUGE_VALL es devuelto.

Si ocurre un error de rango debido a desbordamiento inferior, se devuelve el resultado correcto (después del redondeo).

Manejo de errores

Los errores se reportan como se especifica en math_errhandling .

Si base es finito y negativo y exponent es finito y no entero, ocurre un error de dominio y puede ocurrir un error de rango.

Si base es cero y exponent es cero, puede ocurrir un error de dominio.

Si base es cero y exponent es negativo, puede ocurrir un error de dominio o un error de polo.

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

• pow ( + 0 , exponent ) , donde exponent es un entero impar negativo, retorna +∞ y genera FE_DIVBYZERO
• pow ( - 0 , exponent ) , donde exponent es un entero impar negativo, retorna -∞ y genera FE_DIVBYZERO
• pow ( ± 0 , exponent ) , donde exponent es negativo, finito, y es un entero par o un no entero, retorna +∞ y genera FE_DIVBYZERO
• pow ( ± 0 , - ∞ ) devuelve +∞ y puede generar FE_DIVBYZERO (hasta C23)
• pow ( + 0 , exponent ) , donde exponent es un entero impar positivo, retorna +0
• pow ( - 0 , exponent ) , donde exponent es un entero positivo impar, retorna -0
• pow ( ± 0 , exponent ) , donde exponent es un número positivo no entero o un entero par positivo, retorna +0
• pow ( - 1 , ±∞ ) devuelve 1
• pow ( + 1 , exponent ) devuelve 1 para cualquier exponent , incluso cuando exponent es NaN
• pow ( base, ± 0 ) devuelve 1 para cualquier base , incluso cuando base es NaN
• pow ( base, exponent ) devuelve NaN y genera FE_INVALID si base es finita y negativa y exponent es finito y no entero.
• pow ( base, - ∞ ) devuelve +∞ para cualquier |base|<1
• pow ( base, - ∞ ) devuelve +0 para cualquier |base|>1
• pow ( base, + ∞ ) devuelve +0 para cualquier |base|<1
• pow ( base, + ∞ ) devuelve +∞ para cualquier |base|>1
• pow ( - ∞, exponent ) devuelve -0 si exponent es un entero impar negativo
• pow ( - ∞, exponente ) retorna +0 si exponente es un no entero negativo o un entero par negativo
• pow ( - ∞, exponent ) devuelve -∞ si exponent es un entero impar positivo
• pow ( - ∞, exponent ) devuelve +∞ si exponent es un número positivo no entero o un entero par positivo
• pow ( + ∞, exponent ) devuelve +0 para cualquier exponent negativo
• pow ( + ∞, exponent ) devuelve +∞ para cualquier exponent positivo
• excepto donde se especifique anteriormente, si cualquier argumento es NaN, se devuelve NaN.

Notas

Aunque pow no puede utilizarse para obtener una raíz de un número negativo, cbrt se proporciona para el caso común donde exponent es 1 / 3 .

Ejemplo

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    // uso típico
    printf("pow(2, 10) = %f\n", pow(2, 10));
    printf("pow(2, 0.5) = %f\n", pow(2, 0.5));
    printf("pow(-2, -3) = %f\n", pow(-2, -3));
    // valores especiales
    printf("pow(-1, NAN) = %f\n", pow(-1, NAN));
    printf("pow(+1, NAN) = %f\n", pow(+1, NAN));
    printf("pow(INFINITY, 2) = %f\n", pow(INFINITY, 2));
    printf("pow(INFINITY, -1) = %f\n", pow(INFINITY, -1));
    // manejo de errores
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("pow(-1, 1/3) = %f\n", pow(-1, 1.0 / 3));
    if (errno == EDOM)
        perror("    errno == EDOM");
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
    feclearexcept(FE_ALL_EXCEPT);
    printf("pow(-0, -3) = %f\n", pow(-0.0, -3));
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

pow(2, 10) = 1024.000000
pow(2, 0.5) = 1.414214
pow(-2, -3) = -0.125000
pow(-1, NAN) = nan
pow(+1, NAN) = 1.000000
pow(INFINITY, 2) = inf
pow(INFINITY, -1) = 0.000000
pow(-1, 1/3) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised
pow(-0, -3) = -inf
    FE_DIVBYZERO raised

Referencias

Véase también