---
title: floor
description: "返回不大于x的最大整数值。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0237.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0237.html
indexId: 316247d11d9540932bcca26a928db3f0e79309da80c937294fcd9ac2f4bf029561
---
# floor

返回不大于x的最大整数值。

#### 接口定义

C interface：

float floorf(float x);

double floor(double x);

long double floorl(long double x);


#### 参数

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


#### 返回值

- 返回x的向下取整后的值，x ∈ (-inf, inf)。
- 输入+0，返回+0。
- 输入-0，返回-0。
- 输入±∞，返回±∞。
- 输入nan，返回nan。


#### 依赖

C: "km.h"


#### 示例

C interface：```
// typical usage
    double x1 = 0.0, x2 = -0.0, x3 = 1.5, x4 = -2.5;
    // special handling
    double a = INFINITY, b = -INFINITY, c = NAN;
    // print result
    printf("floor(0.0) = %.15f\n", floor(x1));
    printf("floor(-0.0) = %.15f\n", floor(x2));
    printf("floor(1.5) = %.15f\n", floor(x3));
    printf("floor(-2.5) = %.15f\n", floor(x4));
    printf("floor(INFINITY) = %.15f\n", floor(a));
    printf("floor(-INFINITY) = %.15f\n", floor(b));
    printf("floor(NAN) = %.15f\n", floor(c));
    /* 
     * floor(0.0) = 0.000000000000000
     * floor(-0.0) = -0.000000000000000
     * floor(1.5) = 1.000000000000000
     * floor(-2.5) = -3.000000000000000
     * floor(INFINITY) = inf
     * floor(-INFINITY) = -inf
     * floor(NAN) = nan
     * */
```