---
title: fdim
description: "如果x≤y，则fdim函数返回零值，否则返回x - y的值。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0207.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0207.html
indexId: 6b9b90fa5b799d8d3361cdbc9c3b1c54fbf23deb5ae5f4e7d22d34120f16d8e161
---
# fdim

如果x≤y，则fdim函数返回零值，否则返回x - y的值。

#### 接口定义

C interface：

float fdimf(float x, float y);

double fdim(double x, double y);


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| x | 在fdimf中，x是单精度浮点类型。 在fdim中，x是双精度浮点类型。 | 表示输入数据的浮点值。 | 输入 |
| y | 在fdimf中，y是单精度浮点类型。 在fdim中，y是双精度浮点类型。 | 表示输入数据的浮点值。 | 输入 |


#### 返回值

- errno：返回值为inf时，置ERANGE。
- 输入x<y时，返回0。
- 输入x>=y时，返回x-y的值。
- 输入x或y为nan时，返回nan。


#### 依赖

C: "km.h"


#### 示例

C interface：```
// typical usage
    printf("fdim(1.0, 2.0) = %.15f\n", fdim(1.0, 2.0));
    printf("fdim(3.0, 2.0) = %.15f\n", fdim(3.0, 2.0));
    // special handling
    printf("fdim(INFINITY, INFINITY) = %.15f\n", fdim(INFINITY, INFINITY));
    printf("fdim(INFINITY, -INFINITY) = %.15f\n", fdim(INFINITY, -INFINITY));
    printf("fdim(-INFINITY, INFINITY) = %.15f\n", fdim(-INFINITY, INFINITY));
    printf("fdim(-INFINITY, -INFINITY) = %.15f\n", fdim(-INFINITY, -INFINITY));
    printf("fdim(NAN, -INFINITY) = %.15f\n", fdim(NAN, -INFINITY));

 result
   /* 
    * fdim(1.0, 2.0) = 0.000000000000000
    * fdim(3.0, 2.0) = 1.000000000000000
    * fdim(INFINITY, INFINITY) = 0.000000000000000
    * fdim(INFINITY, -INFINITY) = inf
    * fdim(-INFINITY, INFINITY) = 0.000000000000000
    * fdim(-INFINITY, -INFINITY) = 0.000000000000000
    * fdim(NAN, -INFINITY) = nan
    * */
```