SCALBLN - Linux手册页

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

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

名称

scalbn,scalbnf,scalbnl,scalbln,scalblnf,scalblnl-将浮点数乘以基数的整数

语法

#包括

double scalbln(double x,long int exp);
float scalblnf(float x,long int exp);
long double scalblnl(long double x,long int exp);

double scalbn(double x,int exp);
浮动scalbnf(float x,int exp);
long double scalbnl(long double x,int exp);

与-lm链接。

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

scalbln(),scalblnf(),scalblnl():

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || / *自glibc 2.19起:* / -_DEFAULT_SOURCE
scalbn(),

scalbnf(),

scalbnl():

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

说明

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

x * FLT_RADIX ** exp

可以通过包含FLT_RADIX来定义。

返回值

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

如果x为NaN,则返回NaN。

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

如果x为+0(-0),则返回+0(-0)。

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

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

错误说明

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

可能会发生以下错误:

Range error, overflow
引发了一个溢出浮点异常(FE_OVERFLOW)。
Range error, underflow
errno设置为ERANGE。下溢浮点异常(FE_UNDERFLOW)被引发。

版本

这些功能首先出现在2.1版的glibc中。

属性

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

InterfaceAttributeValue
scalbn(),scalbnf(),scalbnl(),
scalbln(),scalblnf(),scalblnl()
Thread safetyMT-Safe

遵循规范

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

备注

这些函数与scalb(3)中描述的过时函数的第二个自变量类型不同。本页中描述的函数具有整数类型的第二个参数,而scalb(3)中的函数具有double类型的第二个参数。

如果FLT_RADIX等于2(通常),那么scalbn()等于ldexp(3)。

BUGS

在glibc 2.20之前,这些函数未将errno设置为范围错误。

另外参见

ldexp(3),scalb(3)

出版信息

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