当前位置： C语言 -- 标准库 -- <math.h> -- fromfpxd128

fromfpxd128函数

概要：

#include <math.h>
#ifdef __STDC_IEC_60559_DFP__
    _Decimal128 fromfpxd128(_Decimal128  $x$ , int  $rnd$ , unsigned int  $width$ );
#endif

描述：

该函数根据参数 $rnd$ 指定的舍入方向，将参数 $x$ 舍入为浮点形式表示的有符号整数。

如果参数 $width$ 不为0，并且舍入得到的结果整数值在 $[- 2^{(width–1)}, 2^{(width–1)} - 1]$ 区间范围内，函数返回浮点形式表示的整数值。如果参数 $width$ 为0，或者参数 $x$ 不能舍入到上述范围内的整数，函数返回NaN（如果可以，NaN与参数 $x$ 具有相同类型。）；否则返回参数 $x$ 的值，并发生域错误。

如果参数 $rnd$ 值不等于舍入方向宏，则舍入方向是未指定的。

该函数与fromfpd128函数唯一的不同是：如果舍入后得到的结果在不超过指定位宽的情况下，数值上与参数 $x$ 不同，该函数会引发FE_INEXACT浮点异常。

参数：

_Decimal128

x

参数为_Decimal128类型浮点数。

int

rnd

参数为int类型整数，其值应为FP_INT_UPWARD、FP_INT_DOWNWARD、FP_INT_TOWARDZERO、FP_INT_TONEARESTFROMZERO、FP_INT_TONEAREST之一。

unsigned int

width

参数为unsigned int类型整数，表示有符号整数类型的宽度，例如：INT_WIDTH。

返回值：

函数返回浮点形式表示的舍入得到的有符号整数值。

范例：

/*函数fromfpxd128范例*/

#include <limits.h>
#include <math.h>
#include <stdio.h>

int main(void)
{
    #if __STDC_VERSION_MATH_H__ >= 202311L && defined(__STDC_IEC_60559_DFP__)
      printf("FP_INT_UPWARD:");
      printf(" %.2DDf\n", fromfpxd128(2.5dl, FP_INT_UPWARD, INT_WIDTH));
      printf("FP_INT_DOWNWARD:");
      printf(" %.2DDf\n", fromfpxd128(2.5dl, FP_INT_DOWNWARD, INT_WIDTH));
      printf("FP_INT_TOWARDZERO:");
      printf(" %.2DDf\n", fromfpxd128(2.5dl, FP_INT_TOWARDZERO, INT_WIDTH));
      printf("FP_INT_TONEAREST:");
      printf(" %.2DDf\n", fromfpxd128(2.5dl, FP_INT_TONEAREST, INT_WIDTH));
      printf("FP_INT_TONEARESTFROMZERO:");
      printf(" %.2DDf\n", fromfpxd128(2.5dl, FP_INT_TONEARESTFROMZERO, INT_WIDTH));
    #else
      puts("The implementation does not support fromfpxd128 function.");
    #endif

    return 0;
}

可能输出：

FP_INT_UPWARD: 3.00

FP_INT_DOWNWARD: 2.00

FP_INT_TOWARDZERO: 2.00

FP_INT_TONEAREST: 2.00

FP_INT_TONEARESTFROMZERO: 3.00

（注：编译时实现还未支持fromfpxd128函数。）

fromfpx	将double类型参数根据舍入方向舍入为有符号整数的函数。
fromfpxf	将float类型参数根据舍入方向舍入为有符号整数的函数。
fromfpxl	将long double类型参数根据舍入方向舍入为有符号整数的函数。
fromfpxd32	将_Decimal32类型参数根据舍入方向舍入为有符号整数的函数。
fromfpxd64	将_Decimal64类型参数根据舍入方向舍入为有符号整数的函数。