---
title: fdim
description: "如果x≤y，则fdim函数返回零值，否则返回x - y的值。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_kml_16_0009.html
sourcePath: /source/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_kml_16_0009.html
indexId: cdd1537769c26c2ac123483e90e58aed618f96759849622dea989818e85d148876
---
# 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 handing
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
* */
```