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

float       sqrt ( float num );
double      sqrt ( double num );
long double sqrt ( long double num );

/*floating-point-type*/
            sqrt ( /*floating-point-type*/ num );

float       sqrtf( float num );

long double sqrtl( long double num );

template< /*math-floating-point*/ V >
constexpr /*deduced-simd-t*/<V> 
            sqrt ( const V& v_num );

template< class Integer >
double      sqrt ( Integer num );

Параметры

Возвращаемое значение

Если ошибок не возникает, возвращается квадратный корень из num (\({\small \sqrt{num} }\)√num).

При возникновении ошибки области определения возвращается значение, определяемое реализацией (NaN, если поддерживается).

При возникновении ошибки диапазона из-за потери порядка возвращается правильный результат (после округления).

Обработка ошибок

Об ошибках сообщается в соответствии с math_errhandling.

Ошибка области определения возникает, если num меньше нуля.

Если реализация поддерживает арифметику с плавающей точкой IEEE (IEC 60559),

• Если аргумент меньше -0, возникает FE_INVALID и возвращается NaN.
• Если аргумент равен +∞ или ±0, он возвращается без изменений.
• Если аргумент равен NaN, возвращается NaN.

Примечания

Стандарт IEEE требует, чтобы std::sqrt выполняла корректное округление точного результата. В частности, точный результат выдается, если он может быть представлен в типе с плавающей точкой. Единственные другие операции, для которых это требуется, — арифметические операторы и функция std::fma. Другие функции, включая std::pow, такими требованиями не связаны.

Не требуется, чтобы дополнительные перегрузки были предоставлены в точности в виде (A). Они должны лишь обеспечивать, чтобы для аргумента num целочисленного типа std::sqrt(num) имела тот же эффект, что и std::sqrt(static_cast<double>(num)).

Пример

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON

int main()
{
    // normal use
    std::cout << "sqrt(100) = " << std::sqrt(100) << '\n'
              << "sqrt(2) = " << std::sqrt(2) << '\n'
              << "golden ratio = " << (1 + std::sqrt(5)) / 2 << '\n';
    
    // special values
    std::cout << "sqrt(-0) = " << std::sqrt(-0.0) << '\n';
    
    // error handling
    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 raised\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

См. также