sqrt, sqrtf, sqrtl

Paramètres

Valeur de retour

Si aucune erreur ne se produit, la racine carrée de arg ( \({\small \sqrt{arg} }\) √ arg ) est retournée.

Si une erreur de domaine se produit, une valeur définie par l'implémentation est retournée (NaN là où supporté).

Si une erreur de plage se produit en raison d'un dépassement inférieur, le résultat correct (après arrondi) est retourné.

Gestion des erreurs

Les erreurs sont signalées comme spécifié dans math_errhandling .

Une erreur de domaine se produit si arg est inférieur à zéro.

Si l'implémentation prend en charge l'arithmétique à virgule flottante IEEE (IEC 60559),

• Si l'argument est inférieur à -0, FE_INVALID est déclenché et NaN est retourné.
• Si l'argument est +∞ ou ±0, il est retourné, non modifié.
• Si l'argument est NaN, NaN est retourné.

Notes

sqrt est requis par la norme IEEE pour être correctement arrondi à partir du résultat infiniment précis. En particulier, le résultat exact est produit s'il peut être représenté dans le type à virgule flottante. Les seules autres opérations qui exigent cela sont les opérateurs arithmétiques et la fonction fma . D'autres fonctions, y compris pow , ne sont pas soumises à cette contrainte.

Exemple

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    // utilisation normale
    printf("sqrt(100) = %f\n", sqrt(100));
    printf("sqrt(2) = %f\n", sqrt(2));
    printf("golden ratio = %f\n", (1 + sqrt(5)) / 2);
    // valeurs spéciales
    printf("sqrt(-0) = %f\n", sqrt(-0.0));
    // gestion d'erreur
    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

Références

Voir aussi