sqrt, sqrtf, sqrtl

float       sqrtf( float arg );

double      sqrt( double arg );

long double sqrtl( long double arg );

#define sqrt( arg )

Параметры

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

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

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

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

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

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

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

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

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

Примечания

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

Пример

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON

int main(void)
{
    // normal use
    printf("sqrt(100) = %f\n", sqrt(100));
    printf("sqrt(2) = %f\n", sqrt(2));
    printf("golden ratio = %f\n", (1 + sqrt(5)) / 2);

    // special values
    printf("sqrt(-0) = %f\n", sqrt(-0.0));

    // error handling
    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

Ссылки

• Стандарт C23 (ISO/IEC 9899:2024):
• 7.12.7.5 Функции sqrt (стр.: уточняется)
• 7.25 Обобщённые по типу математические функции <tgmath.h> (стр.: уточняется)
• F.10.4.5 Функции sqrt (стр.: уточняется)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.12.7.5 Функции sqrt (стр.: уточняется)
• 7.25 Обобщённые по типу математические функции <tgmath.h> (стр.: уточняется)
• F.10.4.5 Функции sqrt (стр.: уточняется)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.12.7.5 Функции sqrt (стр.: 249)
• 7.25 Обобщённые по типу математические функции <tgmath.h> (стр.: 373-375)
• F.10.4.5 Функции sqrt (стр.: 525)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.12.7.5 Функции sqrt (стр.: 229-230)
• 7.22 Обобщённые по типу математические функции <tgmath.h> (стр.: 335-337)
• F.9.4.5 Функции sqrt (стр.: 462)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.5.5.2 Функция sqrt

См. также