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版本

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)。

遵循规范

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/。