std:: sqrt, std:: sqrtf, std:: sqrtl

Paramètres

Valeur de retour

Si aucune erreur ne se produit, la racine carrée de num ( \({\small \sqrt{num} }\) √ num ) 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 num 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

std::sqrt est requis par la norme IEEE d'ê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 std::fma . D'autres fonctions, y compris std::pow , ne sont pas aussi contraintes.

Les surcharges supplémentaires ne sont pas requises d'être fournies exactement comme (A) . Elles doivent seulement être suffisantes pour garantir que pour leur argument num de type entier, std :: sqrt ( num ) ait le même effet que std :: sqrt ( static_cast < double > ( num ) ) .

Exemple

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    // utilisation normale
    std::cout << "sqrt(100) = " << std::sqrt(100) << '\n'
              << "sqrt(2) = " << std::sqrt(2) << '\n'
              << "golden ratio = " << (1 + std::sqrt(5)) / 2 << '\n';
    // valeurs spéciales
    std::cout << "sqrt(-0) = " << std::sqrt(-0.0) << '\n';
    // gestion des erreurs
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "sqrt(-1.0) = " << std::sqrt(-1) << '\n';
    if (errno == EDOM)
        std::cout << "    errno = EDOM " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID levée\n";
}

sqrt(100) = 10
sqrt(2) = 1.41421
golden ratio = 1.61803
sqrt(-0) = -0
sqrt(-1.0) = -nan
    errno = EDOM Numerical argument out of domain
    FE_INVALID raised

Voir aussi