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

Определено в заголовке `<cmath>`
	(1)
float sqrt ( float num ); double sqrt ( double num ); long double sqrt ( long double num );		(до C++23)
/* floating-point-type / sqrt ( / floating-point-type */ num );		(с C++23) (constexpr с C++26)
float sqrtf( float num );	(2)	(с C++11) (constexpr с C++26)
long double sqrtl( long double num );	(3)	(с C++11) (constexpr с C++26)
Дополнительные перегрузки (с C++11)
Определено в заголовке `<cmath>`
template< class Integer > double sqrt ( Integer num );	(A)	(constexpr с C++26)

1-3) Вычисляет квадратный корень из num. Библиотека предоставляет перегрузки std::sqrt для всех типов с плавающей точкой без квалификаторов cv в качестве типа параметра.(с C++23)

A) Предоставляются дополнительные перегрузки для всех целочисленных типов, которые обрабатываются как double.

(с C++11)

Параметры

num

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

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

Если ошибок не произошло, возвращается квадратный корень из 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()
{
    // 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

См. также

powpowfpowl (C++11)(C++11)	возводит число в заданную степень (\(\small{x^y}\)x^y) (функция)
cbrtcbrtfcbrtl (C++11)(C++11)(C++11)	вычисляет кубический корень (\(\small{\sqrt[3]{x}}\)3√x) (функция)
hypothypotfhypotl (C++11)(C++11)(C++11)	вычисляет квадратный корень из суммы квадратов двух или трех(с C++17) заданных чисел (\(\scriptsize{\sqrt{x^2+y^2}}\)√x²+y²), (\(\scriptsize{\sqrt{x^2+y^2+z^2}}\)√x²+y²+z²)(с C++17) (функция)
sqrt(std::complex)	комплексный квадратный корень в диапазоне правой полуплоскости (шаблон функции)
sqrt(std::valarray)	применяет функцию `std::sqrt` к каждому элементу valarray (шаблон функции)
Документация C для `sqrt`

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