SCALB - Linux手册页

时间:2019-08-20 18:01:13  来源:igfitidea点击:

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

名称

scalb,scalbf,scalbl-浮点数乘以基数的整数幂(OBSOLETE)

语法

#包括

double scalb(double x,double exp);
浮动scalbf(float x,float exp);
long double scalbl(long double x,long double exp);

与-lm链接。

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

scalb():

_XOPEN_SOURCE>= 500 || / *自glibc 2.19起:* / -_DEFAULT_SOURCE || / * Glibc版本
scalbf(),

scalbl():

_XOPEN_SOURCE>= 600 || / *自glibc 2.19起:* / -_DEFAULT_SOURCE || / * Glibc版本

说明

这些函数将它们的第一个参数x乘以FLT_RADIX(可能是2)以得到exp的幂,即:

x * FLT_RADIX ** exp

可以通过包含FLT_RADIX来定义。

返回值

成功后,这些函数将返回x * FLT_RADIX ** exp。

如果x或exp为NaN,则返回NaN。

如果x为正无穷大(负无穷大),而exp不是负无穷大,则返回正无穷大(负无穷大)。

如果x为+0(-0),并且exp不是正无穷大,则返回+0(-0)。

如果x为零,且exp为正无穷大,则会发生域错误,并返回NaN。

如果x是无穷大,而exp是负无穷大,则会发生域错误,并返回NaN。

如果结果溢出,则会发生范围错误,并且函数将分别返回HUGE_VAL,HUGE_VALF或HUGE_VALL,并带有与x相同的符号。

如果结果下溢,则会发生范围错误,并且函数将返回零,其符号与x相同。

错误说明

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

可能会发生以下错误:

Domain error: xis 0, and expis positive infinity, or xis positive infinity and expis negative infinity and the other argument is not a NaN
errno设置为EDOM。引发了无效的浮点异常(FE_INVALID)。
Range error, overflow
errno设置为ERANGE。引发了一个溢出浮点异常(FE_OVERFLOW)。
Range error, underflow
errno设置为ERANGE。下溢浮点异常(FE_UNDERFLOW)被引发。

属性

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

InterfaceAttributeValue
scalb(),scalbf(),scalbl()Thread safetyMT-Safe

遵循规范

scalb()在POSIX.1-2001中指定,但标记为过时。 POSIX.1-2008删除了scalb()的规范,建议改用scalbln(3),scalblnf(3)或scalblnl(3)。 scalb()函数来自4.3BSD。

scalbf()和scalbl()是未标准化的; scalbf()仍然存在于其他几个系统上

BUGS

在glibc 2.20之前,这些函数未针对域和范围错误设置errno。

另外参见

ldexp(3),scalbln(3)

出版信息

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