ldexp, ldexpf, ldexpl - C++ Builder 参考手册

函数原型	C90	C99	C++98	C++11
double ldexp(double x, int y);	√	√	√	√
float ldexpf(float x, int y);		√
long double ldexpl(long double x, int y);		√
float ldexp(float x, int y);			√	√
long double ldexp(long double x, int y);			√	√

头文件：

#include <cmath>

命名空间：

std

参数：

x：用二进位科学计数法表示的数据的有效数字，定义域范围为 [-Infinity, +Infinity]，并不限于 (-1.0, -0.5] ∪ [0.5, 1.0)
y：指数，2 的 y 次幂 2^y

返回值：

返回值：x 乘以 2 的 y 次幂：x * 2^y，即 x * exp2(y)，值域范围：[-Infinity, +Infinity]
NAN：定义域错误，此时全局变量 errno 的值为 EDOM。
计算可能会溢出，此时全局变量 errno 的值为 ERANGE。

例：12.34 = 0.77125 × 2⁴
-8.2 × 10^-20 = -0.756316507022092 × 2^-63

例子：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
double Xes[] = { 12.34, -987.65, 5.43e50, -8.2e-20, (double)Infinity, (double)-Infinity };

UnicodeString s;
for(size_t i=0; i<sizeof(Xes)/sizeof(Xes[0]); i++)
   {
   double x = Xes[i];
   int y;
   double w = std::frexp(x, &y);

   Memo1->Lines->Add(s.sprintf(L"%g = %g * exp2(%d)", x, w, y));
   Memo1->Lines->Add(s.sprintf(L"%g * exp2(%d) = %g", w, y, w*std::exp2(y)));
   Memo1->Lines->Add(s.sprintf(L"ldexp(%g, %d) = %g", w, y, std::ldexp(w,y)));
   Memo1->Lines->Add(L"");
   }
}

12.34 = 0.77125 * exp2(4) 即 12.34 = 0.77125 × 2⁴
-8.2E-20 = -0.756316507022092 * exp2(-63) 即 -8.2 × 10^-20 = -0.756316507022092 × 2^-63

兼容性：

函数 \ C++ Builder 编译器	bcc32	clang32	clang64
ldexp	√	√	√
ldexpf		版本 ≥ 10.2 Tokyo Update 1	√
ldexpl	√	√	√

相关链接：

• frexp • exp2 • exp • pow • _matherr • 浮点数异常处理

◤上一页：hypot, hypotf, hypotl

下一页：log, logf, logl◢

C++ 爱好者 -- Victor Chen 的个人网站