NEXTAFTER - Linux手册页

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

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

名称

nextafter,nextafterf,nextafterl,nexttoward,nexttowardf,nexttowardl-浮点数操作

语法

#包括

double nextafter(double x,double y);
浮点数nextafterf(float x,float y);
long double nextafterl(long double x,long double y);

double nexttoward(double x,long double y);
float nexttowardf(float x,long double y);
long double nexttowardl(long double x,long double y);

与-lm链接。

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

nextafter():

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

nextafterl():

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

nexttowardf(),

nexttowardl():

_XOPEN_SOURCE>= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L

说明

nextafter(),nextafterf()和nextafterl()函数返回沿x沿y方向的下一个可表示的浮点值。如果y小于x,则这些函数将返回小于x的最大可表示数字。

如果x等于y,则函数返回y。

nexttoward(),nexttowardf()和nexttowardl()函数的作用与相应的nextafter()函数相同,只是它们具有较长的doublesecond参数。

返回值

成功执行后,这些函数将在y方向上返回x之后的下一个可表示的浮点值。

如果x等于y,则返回y(与x具有相同的类型)。

如果x或y是NaN,则返回NaN。

如果x是有限的,并且结果将溢出,则将发生范围错误,并且函数将分别以正确的数学符号返回HUGE_VAL,HUGE_VALF或HUGE_VALL。

如果x不等于y,并且正确的函数结果为次正规,零或下溢,则会发生范围错误,并返回正确的值(如果可以表示)或0.0。

错误说明

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

可能会发生以下错误:

Range error: result overflow
errno设置为ERANGE。引发了一个溢出浮点异常(FE_OVERFLOW)。
Range error: result is subnormal or underflows
errno设置为ERANGE。下溢浮点异常(FE_UNDERFLOW)被引发。

属性

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

InterfaceAttributeValue
nextafter(),nextafterf(),
nextafterl(),nexttoward(),
nexttowardf(),nexttowardl()
Thread safetyMT-Safe

遵循规范

C99,POSIX.1-2001,POSIX.1-2008。此功能在IEC 559中定义(以及在IEEE 754 / IEEE 854中具有推荐功能的附录)。

BUGS

在glibc 2.5版及更早版本中,发生下溢时,这些函数不会引发下溢浮点(FE_UNDERFLOW)异常。

BUGS

在glibc 2.23版之前,这些功能未设置errno。

另外参见

附近的人(3)

出版信息

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