sqrt, sqrtf, sqrtl

Defined in header `<math.h>`
float sqrtf( float arg );	(1)	(since C99)
double sqrt( double arg );	(2)
long double sqrtl( long double arg );	(3)	(since C99)
Defined in header `<tgmath.h>`
#define sqrt( arg )	(4)	(since C99)

1-3) Вычисляет квадратный корень из arg.

4) Универсальный макрос для типов: если arg имеет тип long double, вызывается sqrtl. В противном случае, если arg имеет целочисленный тип или тип double, вызывается sqrt. В противном случае, вызывается sqrtf. Если arg является комплексным или мнимым числом, макрос вызывает соответствующую комплексную функцию (csqrtf, csqrt, csqrtl).

Параметры

arg

значение с плавающей точкой

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

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

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

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

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

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

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

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

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

Примечания

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

Пример

#include <stdio.h>
#include <math.h>
#include <errno.h>
#include <fenv.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

Ссылки

Стандарт 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

См. также

powpowfpowl (C99)(C99)	вычисляет число, возведённое в заданную степень (\(\small{x^y}\)x^y) (функция)
cbrtcbrtfcbrtl (C99)(C99)(C99)	вычисляет кубический корень (\(\small{\sqrt[3]{x} }\)3√x) (функция)
hypothypotfhypotl (C99)(C99)(C99)	вычисляет квадратный корень из суммы квадратов двух заданных чисел (\(\scriptsize{\sqrt{x^2+y^2} }\)√x²+y²) (функция)
csqrtcsqrtfcsqrtl (C99)(C99)(C99)	вычисляет комплексный квадратный корень (функция)
Документация C++ для `sqrt`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/numeric/math/sqrt