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

Parameter

Rückgabewert

Wenn keine Fehler auftreten, wird die Quadratwurzel von num ( \({\small \sqrt{num} }\) √ num ) zurückgegeben.

Wenn ein Domänenfehler auftritt, wird ein implementierungsdefinierter Wert zurückgegeben (NaN, sofern unterstützt).

Wenn ein Bereichsfehler aufgrund von Unterlauf auftritt, wird das korrekte Ergebnis (nach Rundung) zurückgegeben.

Fehlerbehandlung

Fehler werden gemeldet, wie in math_errhandling spezifiziert.

Ein Domänenfehler tritt auf, wenn num kleiner als null ist.

Wenn die Implementierung IEEE-Gleitkommaarithmetik (IEC 60559) unterstützt,

• Wenn das Argument kleiner als -0 ist, FE_INVALID wird ausgelöst und NaN wird zurückgegeben.
• Wenn das Argument +∞ oder ±0 ist, wird es unverändert zurückgegeben.
• Wenn das Argument NaN ist, wird NaN zurückgegeben.

Hinweise

std::sqrt ist laut IEEE-Standard verpflichtet, das unendlich genaue Ergebnis korrekt zu runden. Insbesondere wird das exakte Ergebnis erzeugt, wenn es im Fließkommatyp dargestellt werden kann. Die einzigen anderen Operationen, die dies erfordern, sind die arithmetischen Operatoren und die Funktion std::fma . Andere Funktionen, einschließlich std::pow , unterliegen dieser Einschränkung nicht.

Die zusätzlichen Überladungen müssen nicht exakt wie in (A) bereitgestellt werden. Sie müssen lediglich sicherstellen, dass für ihr Argument num vom Ganzzahltyp std :: sqrt ( num ) dieselbe Wirkung hat wie std :: sqrt ( static_cast < double > ( num ) ) .

Beispiel

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    // normale Verwendung
    std::cout << "sqrt(100) = " << std::sqrt(100) << '\n'
              << "sqrt(2) = " << std::sqrt(2) << '\n'
              << "golden ratio = " << (1 + std::sqrt(5)) / 2 << '\n';
    // spezielle Werte
    std::cout << "sqrt(-0) = " << std::sqrt(-0.0) << '\n';
    // Fehlerbehandlung
    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 ausgelöst\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 ausgelöst

Siehe auch