std::scalbn

Defined in header <cmath>	?	?
float scalbn( float x, int exp );	(1)	(since C++11)
double scalbn( double x, int exp );	(2)	(since C++11)
long double scalbn( long double x, int exp );	(3)	(since C++11)
double scalbn( Integral x, int exp );	(4)	(since C++11)
float scalbln( float x, long exp );	(5)	(since C++11)
double scalbln( double x, long exp );	(6)	(since C++11)
long double scalbln( long double x, long exp );	(7)	(since C++11)
double scalbln( Integral x, long exp );	(8)	(since C++11)

1-3，5-7%29乘以浮点值x通过FLT_RADIX升为权力exp...

4，8%29一组过载或接受任意参数的函数模板积分型等效于%282%29或%286%29%28的参数转换为double29%。

参数

x	-	floating point value
exp	-	integer value

返回值

如果没有错误发生，x乘以FLT_RADIX到…的力量arg%28x×FLT[医]放射线

%29被返回。

如果溢出导致范围错误，±HUGE_VAL，，，±HUGE_VALF，或±HUGE_VALL会被归还。

如果由于下流发生范围错误，则返回舍入%29后的正确结果%28。

错误处理

错误按数学[医]错误处理...

如果实现支持ieee浮点算法%28IEC 60559%29，

除非发生距离错误，FE_INEXACT永远不会提高%28，结果是精确的%29。

除非发生距离错误，当前舍入模式被忽略

如果x是±0，它被返回，未经修改

如果x是±∞，它被返回，未经修改

如果exp是0，那么x被返回，未修改

如果x是南，南回来了

注记

关于二进制系统%28FLT_RADIX是2%29，std::scalbn等于std::ldexp...

尽管std::scalbn和std::scalbln指定用于高效执行操作，在许多实现中，它们比使用算术运算符的乘除效率低2倍。

函数名表示“新头皮”，其中scalb是一个较旧的非标准函数，其第二个参数具有浮点类型。

大scalbln函数之所以提供，是因为从最小的正浮点值到最大的有限浮点值的比例所需的因子可能大于标准保证的32767。INT_MAX特别是80位long double，因子为32828。

GNU实现没有设置errno不管...math_errhandling...

例

二次

#include <iostream>
#include <cmath>
#include <cerrno>
#include <cstring>
#include <cfenv>
 
#pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "scalbn(7, -4) = " << std::scalbn(7, -4) << '\n'
              << "scalbn(1, -1074) = " << std::scalbn(1, -1074)
              << " (minimum positive subnormal double)\n"
              << "scalbn(nextafter(1,0), 1024) = "
              << std::scalbn(std::nextafter(1,0), 1024)
              << " (largest finite double)\n";
    // special values
    std::cout << "scalbn(-0, 10) = " << std::scalbn(-0.0, 10) << '\n'
              << "scalbn(-Inf, -1) = " << std::scalbn(-INFINITY, -1) << '\n';
    // error handling
    errno=0; std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "scalbn(1, 1024) = " << std::scalbn(1, 1024) << '\n';
    if(errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if(std::fetestexcept(FE_OVERFLOW))
        std::cout << "    FE_OVERFLOW raised\n";
}

二次

可能的产出：

二次

scalbn(7, -4) = 0.4375
scalbn(1, -1074) = 4.94066e-324 (minimum positive subnormal double)
scalbn(nextafter(1,0), 1024) = 1.79769e+308 (largest finite double)
scalbn(-0, 10) = -0
scalbn(-Inf, -1) = -inf
scalbn(1, 1024) = inf
    errno == ERANGE: Numerical result out of range
    FE_OVERFLOW raised

二次

另见

frexp	decomposes a number into significand and a power of 2 (function)
ldexp	multiplies a number by 2 raised to a power (function)

C标号文件

 ? cppreference.com

在CreativeCommonsAttribution下授权-ShareAlike未移植许可v3.0。

http：//en.cppreference.com/w/cpp/数值/数学/Scalbn

本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com

最后更新于：2017-12-18