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

fromfpxl函数

概要：

#include <math.h>
long double fromfpxl(long double  $x$ , int  $rnd$ , unsigned int  $width$ );

描述：

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

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

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

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

参数：

long double

x

参数为long double类型浮点数。

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。

返回值：

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

范例：

/*函数fromfpxl范例*/

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

int main(void)
{
    #if __STDC_VERSION_MATH_H__ >= 202311L
        printf("FP_INT_UPWARD:");
        printf(" %.2Lf\n", fromfpxl(2.5L, FP_INT_UPWARD, INT_WIDTH));
        printf("FP_INT_DOWNWARD:");
        printf(" %.2Lf\n", fromfpxl(2.5L, FP_INT_DOWNWARD, INT_WIDTH));
        printf("FP_INT_TOWARDZERO:");
        printf(" %.2Lf\n", fromfpxl(2.5L, FP_INT_TOWARDZERO, INT_WIDTH));
        printf("FP_INT_TONEAREST:");
        printf(" %.2Lf\n", fromfpxl(2.5L, FP_INT_TONEAREST, INT_WIDTH));
        printf("FP_INT_TONEARESTFROMZERO:");
        printf(" %.2Lf\n", fromfpxl(2.5L, FP_INT_TONEARESTFROMZERO, INT_WIDTH));
    #else
        puts("The implementation does not support fromfpxl 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

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

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