sqrt, sqrtf, sqrtl

Parámetros

Valor de retorno

Si no ocurren errores, se devuelve la raíz cuadrada de arg ( \({\small \sqrt{arg} }\) √ 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 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 .

Error de dominio ocurre si arg es menor que cero.

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

• Si el argumento es menor que -0, FE_INVALID se activa y se retorna NaN.
• Si el argumento es +∞ o ±0, se retorna sin modificación.
• Si el argumento es NaN, se retorna NaN.

Notas

sqrt es requerido por el estándar IEEE para ser redondeado correctamente a partir del resultado infinitamente preciso. En particular, se produce el resultado exacto si puede ser representado en el tipo de punto flotante. Las únicas otras operaciones que requieren esto son los operadores aritméticos y la función fma . Otras funciones, incluyendo pow , no están tan restringidas.

Ejemplo

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    // uso normal
    printf("sqrt(100) = %f\n", sqrt(100));
    printf("sqrt(2) = %f\n", sqrt(2));
    printf("golden ratio = %f\n", (1 + sqrt(5)) / 2);
    // valores especiales
    printf("sqrt(-0) = %f\n", sqrt(-0.0));
    // manejo de errores
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("sqrt(-1.0) = %f\n", sqrt(-1));
    if (errno == EDOM)
        perror("    errno == EDOM");
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID was raised");
}

sqrt(100) = 10.000000
sqrt(2) = 1.414214
golden ratio = 1.618034
sqrt(-0) = -0.000000
sqrt(-1.0) = -nan
    errno = EDOM: Numerical argument out of domain
    FE_INVALID was raised

Referencias

Véase también