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

Параметры

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

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

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

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

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

Ошибки сообщаются, как указано в math_errhandling .

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

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

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

Примечания

std::sqrt по стандарту IEEE требуется корректное округление от бесконечно точного результата. В частности, точный результат производится, если он может быть представлен в типе с плавающей запятой. Единственными другими операциями, которые требуют этого, являются арифметические операторы и функция 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()
{
    // обычное использование
    std::cout << "sqrt(100) = " << std::sqrt(100) << '\n'
              << "sqrt(2) = " << std::sqrt(2) << '\n'
              << "golden ratio = " << (1 + std::sqrt(5)) / 2 << '\n';
    // специальные значения
    std::cout << "sqrt(-0) = " << std::sqrt(-0.0) << '\n';
    // обработка ошибок
    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

Смотрите также