在线文档教程
C++
数字 | Numerics

std::scalbln

STD::Scalbn,STD::scalbln

Defined in header
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_RADIX2%29,std::scalbn等于std::ldexp...

尽管std::scalbnstd::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

二次

另见

frexpdecomposes a number into significand and a power of 2 (function)
ldexpmultiplies a number by 2 raised to a power (function)

C标号文件

© cppreference.com

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

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