HYPOT - Linux手册页

时间:2019-08-20 18:00:36  来源:igfitidea点击:

Linux程序员手册 第3部分
更新日期: 2017-09-15

名称

hypot,hypotf,hypotl-欧几里得距离函数

语法

#include <math.h>

double hypot(double x, double y);
float hypotf(float x, float y);
long double hypotl(long double x, long double y);

与-lm链接。

glibc的功能测试宏要求(请参阅feature_test_macros(7)):

hypot():

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || _XOPEN_SOURCE || / *自glibc 2.19起:* / -_DEFAULT_SOURCE || / * Glibc版本
hypotf(),

hypotl():

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || / *自glibc 2.19起:* / -_DEFAULT_SOURCE || / * Glibc版本

说明

这些函数返回sqrt(x * x + y * y)。这是边长为x和y的直角三角形的斜边的长度,或者是点(x,y)距原点的距离。

在计算的中间步骤中,执行计算时不会出现不必要的上溢或下溢。

返回值

成功时,这些函数将返回边长为x和y的直角三角形的斜边的长度。

如果x或y是无穷大,则返回正无穷大。

如果x或y是NaN,而另一个参数不是无穷大,则返回NaN。

如果结果溢出,则会发生范围错误,并且这些函数分别返回HUGE_VAL,HUGE_VALF或HUGE_VALL。

如果两个参数都属于非正规变量,并且结果均为非正规变量,则会发生范围错误,并返回正确的结果。

错误说明

有关如何确定调用这些函数时是否发生错误的信息,请参见math_error(7)。

可能会发生以下错误:

Range error: result overflow
errno设置为ERANGE。引发了一个溢出浮点异常(FE_OVERFLOW)。
Range error: result underflow
下溢浮点异常(FE_UNDERFLOW)被引发。
这些功能不会在这种情况下设置errno。

属性

有关本节中使用的术语的说明,请参见attribute(7)。

InterfaceAttributeValue
hypot(),hypotf(),hypotl()Thread safetyMT-Safe

遵循规范

C99,POSIX.1-2001,POSIX.1-2008。

返回double的变体还符合SVr4、4.3BSD。

另外参见

出租车(3),平方(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本,请访问https://www.kernel.org/doc/man-pages/