scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl

来自cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大/最小运算
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)
(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)
(C99)
(C23)
(C23)
三角及双曲函数
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
误差及伽马函数
(C99)
(C99)
(C99)
(C99)
临近整数的浮点运算
(C99)(C99)(C99)
(C99)
(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点操作函数
scalbnscalbln
(C99)(C99)
(C99)(C23)
(C99)
窄化运算
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量与量指数函数
十进制重编码函数
全序与载荷函数
分类
(C99)
(C99)
(C99)
(C23)
类型
宏常量
 
定义于头文件 <math.h>
float       scalbnf( float arg, int exp );
(1) (C99 起)
double      scalbn( double arg, int exp );
(2) (C99 起)
long double scalbnl( long double arg, int exp );
(3) (C99 起)
定义于头文件 <tgmath.h>
#define scalbn( arg, exp )
(4) (C99 起)
定义于头文件 <math.h>
float       scalblnf( float arg, long exp );
(5) (C99 起)
double      scalbln( double arg, long exp );
(6) (C99 起)
long double scalblnl( long double arg, long exp );
(7) (C99 起)
定义于头文件 <tgmath.h>
#define scalbln( arg, exp )
(8) (C99 起)
1-3,5-7) 将浮点值 arg 乘以 FLT_RADIXexp 次幂。
4,8) 泛型宏:若 arg 拥有 long double 类型,则调用 scalbnlscalblnl 。否则,若 arg 拥有整数类型或 double 类型,则调用 scalbnscalbln 。否则调用 scalbnfscalblnf

参数

arg - 浮点值
exp - 整数值

返回值

若不出现错误,则返回 argFLT_RADIXexp 次幂( arg×FLT_RADIXexp
)。

若出现上溢所致的值域错误,则返回 ±HUGE_VAL±HUGE_VALF±HUGE_VALL

若出现下溢所致的值域错误,则返回(舍入后的)正确结果。

错误处理

报告 math_errhandling 中指定的错误。

若实现支持 IEEE 浮点算术( IEC 60559 ),则

  • 决不引发 FE_INEXACT ,除非出现值域错误(结果准确)
  • 忽略当前舍入模式,除非出现值域错误
  • arg 为 ±0 ,则返回不修改的参数
  • arg 为 ±∞ ,则返回不修改的参数
  • exp 为 0 ,则返回不修改的 arg
  • arg 为 NaN ,则返回 NaN

注意

二进制系统上(其中 FLT_RADIX2 ), scalbn 等价于 ldexp

尽管指定 scalbnscalbln 高效进行运算,多数实现上它们的效率低于用算术运算符乘或除以二的幂。

提供 scalbln 函数,因为从最小正浮点值放大到最大正有限值的因子可能大于标准保证的 INT_MAX 32767 。特别是对于 80 位 long double ,因子是 32828 。

GNU 实现不设置 errno ,无关乎 math_errhandling

示例

#include <stdio.h>
#include <math.h>
#include <float.h>
#include <errno.h>
#include <fenv.h>
#pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("scalbn(7, -4) = %f\n", scalbn(7, -4));
    printf("scalbn(1, -1074) = %g (minimum positive subnormal double)\n",
            scalbn(1, -1074));
    printf("scalbn(nextafter(1,0), 1024) = %g (largest finite double)\n",
            scalbn(nextafter(1,0), 1024));
    // 特殊值
    printf("scalbn(-0, 10) = %f\n", scalbn(-0.0, 10));
    printf("scalbn(-Inf, -1) = %f\n", scalbn(-INFINITY, -1));
    // 错误处理
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("scalbn(1, 1024) = %f\n", scalbn(1, 1024));
    if(errno == ERANGE) perror("    errno == ERANGE");
    if(fetestexcept(FE_OVERFLOW)) puts("    FE_OVERFLOW raised");
}

可能的输出:

scalbn(7, -4) = 0.437500
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.000000
scalbn(-Inf, -1) = -inf
scalbn(1, 1024) = inf
    errno == ERANGE: Numerical result out of range
    FE_OVERFLOW raised

引用

  • C11 标准(ISO/IEC 9899:2011):
  • 7.12.6.13 The scalbn functions (p: 247)
  • 7.25 Type-generic math <tgmath.h> (p: 373-375)
  • F.10.3.13 The scalbn functions (p: 523)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.12.6.13 The scalbn functions (p: 228)
  • 7.22 Type-generic math <tgmath.h> (p: 335-337)
  • F.9.3.13 The scalbn functions (p: 460)

参阅

将数拆分成有效数字和 2 的幂次
(函数)
将数乘以 2 的幂
(函数)