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

canonicalize函数

概要：

#include <math.h>
int canonicalize(double * $c x$ , const double * $x$ );

描述：

浮点类型的首选表示形式称为规范表示（canonical representations）；浮点类型也可以包含非规范表示（non-canonical representations）；通常情况下浮点运算结果采用规范表示。

该函数尝试将参数 $x$ 指向对象中的浮点表示转换为规范版本（如同转换为指定类型的临时对象。），然后将规范结果存储到参数 $c x$ 指向的对象中。参数 $x$ 和参数 $c x$ 可以指向同一对象。

如果* $x$ 是信号非数值（signaling NaN），该函数将规范的安静非数值（quiet NaN）存储到参数 $c x$ 指向的对象中。

如果未生成规范结果，参数 $c x$ 指向的对象保持不变。

参数：

double *

c x

参数为指向double类型对象的指针。

const double *

x

参数为指向const double类型对象的指针。

返回值：

如果规范结果存储到参数 $c x$ 指向的对象中，函数返回0；否则返回非0值。

范例：

/*函数canonicalize范例*/

#include <float.h>
#include <math.h>
#include <stdio.h>
#include <string.h>

int main(void)
{
    #if __STDC_VERSION_MATH_H__ >= 202311L && defined(DBL_SNAN)
        double cx = 0.0;
        const double x = DBL_SNAN;
        size_t size = sizeof(double);
        unsigned char arr[size];

        if(canonicalize(&cx, &x) == 0)
        {
            memcpy(arr, &cx, size);

            for(size_t i=0; i<size; i++)
            {
                printf("%02x", arr[size-1-i]);
            }

            printf("\n");
        }
        else
        {
            puts("canonicalize failed.");
        }

    #else
        puts("The implementation does not support canonicalize function or DBL_SNAN macro.");
    #endif

    return 0;
}

输出：

The implementation does not support canonicalize function or DBL_SNAN macro.

canonicalizef	float类型的存储规范结果的函数。
canonicalizel	long double类型的存储规范结果的函数。
canonicalized32	_Decimal32类型的存储规范结果的函数。
canonicalized64	_Decimal64类型的存储规范结果的函数。
canonicalized128	_Decimal128类型的存储规范结果的函数。