---
title: fmin
description: "返回入参的最小值。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0210.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0210.html
indexId: ade063bfd458495d6acc227ad380460b0998891aa37c254b53ecb26dee64c7b061
---
# fmin

返回入参的最小值。

#### 接口定义

C interface：

float fminf(float x, float y);

double fmin(double x, double y);


#### 参数

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


#### 返回值

- 返回x，y中的较小值。
- 其他特殊值参考如下说明。

| 输入值（x） | 输入值（y） | 返回值 |
| --- | --- | --- |
| any | qnan | x |
| qnan | any | y |
| any | snan | nan |
| snan | any | nan |


#### 依赖

C: "km.h"


#### 示例

C interface：```
// typical usage
    double x1 = 0.0, x2 = -0.0, x3 = 1.4, x4 = -2.7;
    double y1 = -0.0, y2 = 0.0, y3 = 1.5, y4 = -2.1;
    // special handling
    double a = INFINITY, b = -INFINITY, c = NAN;
    printf("fmin(0.0, -0.0) = %.15f\n", fmin(x1, y1));
    printf("fmin(-0.0, 0.0) = %.15f\n", fmin(x2, y2));
    printf("fmin(1.4, 1.5) = %.15f\n", fmin(x3, y3));
    printf("fmin(-2.7, -2.1) = %.15f\n", fmin(x4, y4));
    printf("fmin(INFINITY, 1.4) = %.15f\n", fmin(a, x3));
    printf("fmin(-INFINITY, -2.7) = %.15f\n", fmin(b, x4));
    printf("fmin(NAN, 1.4) = %.15f\n", fmin(c, x3));
    printf("fmin(NAN, INFINITY) = %.15f\n", fmin(c, a));
    printf("fmin(NAN, -INFINITY) = %.15f\n", fmin(c, b));
    printf("fmin(INFINITY, -INFINITY) = %.15f\n", fmin(a, b));
    /* 
     *fmin(0.0, -0.0) = -0.000000000000000
     *fmin(-0.0, 0.0) = -0.000000000000000
     *fmin(1.4, 1.5) = 1.400000000000000
     *fmin(-2.7, -2.1) = -2.700000000000000
     *fmin(INFINITY, 1.4) = 1.400000000000000
     *fmin(-INFINITY, -2.7) = -inf
     *fmin(NAN, 1.4) = 1.400000000000000
     *fmin(NAN, INFINITY) = inf
     *fmin(NAN, -INFINITY) = -inf
     *fmin(INFINITY, -INFINITY) = -inf
     * */
```