sqrt, sqrtf, sqrtl

Параметры

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

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

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

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

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

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

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

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

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

Примечания

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

Пример

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    // обычное использование
    printf("sqrt(100) = %f\n", sqrt(100));
    printf("sqrt(2) = %f\n", sqrt(2));
    printf("golden ratio = %f\n", (1 + sqrt(5)) / 2);
    // специальные значения
    printf("sqrt(-0) = %f\n", sqrt(-0.0));
    // обработка ошибок
    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

Ссылки

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