Scroll to navigation

hypot(3) Library Functions Manual hypot(3)

ИМЯ

hypot, hypotf, hypotl - функция, вычисляющая расстояния на евклидовой плоскости

БИБЛИОТЕКА

Math library (libm, -lm)

СИНТАКСИС

#include <math.h>
double hypot(double x, double y);
float hypotf(float x, float y);
long double hypotl(long double x, long double y);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

hypot():


_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| _XOPEN_SOURCE
|| /* Since glibc 2.19: */ _DEFAULT_SOURCE
|| /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

hypotf(), hypotl():


_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

ОПИСАНИЕ

Эти функции возвращают sqrt(x*x+y*y). Это длина гипотенузы прямоугольного треугольника с катетами x и y, или расстояние от начала координат до точки (x,y).

Вычисление выполняется без ненадлежащего переполнения или исчерпал степень при промежуточных шагах вычисления.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

On success, these functions return the length of the hypotenuse of a right-angled triangle with sides of length x and y.

Если x или y стремится к бесконечности, то будет возвращена плюс бесконечность.

Если x или y имеет значение NaN, а другой аргумент не бесконечность, будет возвращено NaN.

Если в результате превышена разрядность, то возникает ошибка диапазона и функции возвращают HUGE_VAL, HUGE_VALF или HUGE_VALL, соответственно.

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

ОШИБКИ

Смотрите math_error(7), чтобы определить, какие ошибки могут возникать при вызове этих функций.

Могут возникать следующие ошибки:

Ошибка диапазона: результат превысил разрядность
Значение errno устанавливается в ERANGE. Возникает исключение переполнения плавающей запятой (FE_OVERFLOW).
Ошибка диапазона: результат исчерпал степень
Возникает исключение исчерпания степени чисел с плавающей запятой (FE_UNDERFLOW).
В этом случае функции не изменяют errno.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс Атрибут Значение
hypot(), hypotf(), hypotl() Безвредность в нитях MT-Safe

СТАНДАРТЫ

C11, POSIX.1-2008.

ИСТОРИЯ

C99, POSIX.1-2001.

Вариант, возвращающий значение типа double, также соответствует SVr4, 4.3BSD.

СМОТРИТЕ ТАКЖЕ

cabs(3), sqrt(3)

ПЕРЕВОД

Русский перевод этой страницы руководства разработал(и) Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

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

2 мая 2024 г. Справочные страницы Linux 6.8