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

fromfpd64函数

概要：

#include <math.h>
#ifdef __STDC_IEC_60559_DFP__
    _Decimal64 fromfpd64(_Decimal64  $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$ 值不等于舍入方向宏，则舍入方向是未指定的。

该函数不会引发FE_INEXACT浮点异常。

参数：

_Decimal64

x

参数为_Decimal64类型浮点数。

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。

返回值：

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

范例：

/*函数fromfpd64范例*/

#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(" %.2Df\n", fromfpd64(2.5dd, FP_INT_UPWARD, INT_WIDTH));
      printf("FP_INT_DOWNWARD:");
      printf(" %.2Df\n", fromfpd64(2.5dd, FP_INT_DOWNWARD, INT_WIDTH));
      printf("FP_INT_TOWARDZERO:");
      printf(" %.2Df\n", fromfpd64(2.5dd, FP_INT_TOWARDZERO, INT_WIDTH));
      printf("FP_INT_TONEAREST:");
      printf(" %.2Df\n", fromfpd64(2.5dd, FP_INT_TONEAREST, INT_WIDTH));
      printf("FP_INT_TONEARESTFROMZERO:");
      printf(" %.2Df\n", fromfpd64(2.5dd, FP_INT_TONEARESTFROMZERO, INT_WIDTH));
    #else
      puts("The implementation does not support fromfpd64 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

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

fromfp	将double类型参数根据舍入方向舍入为有符号整数的函数。
fromfpf	将float类型参数根据舍入方向舍入为有符号整数的函数。
fromfpl	将long double类型参数根据舍入方向舍入为有符号整数的函数。
fromfpd32	将_Decimal32类型参数根据舍入方向舍入为有符号整数的函数。
fromfpd128	将_Decimal128类型参数根据舍入方向舍入为有符号整数的函数。