---
title: __hfma
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_10466.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_10466.html
indexId: 27f4741ad4953591dc23ba2003de02a520c5387210c2037d1b7b64c3c9ae7df677
---
# __hfma

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | x |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | x |
| Atlas 200I/500 A2 推理产品 | x |
| Atlas 推理系列产品 AI Core | x |
| Atlas 推理系列产品 Vector Core | x |
| Atlas 训练系列产品 | x |


#### 功能说明

对输入数据x、y、z，计算x与y相乘加上z的结果。


#### 函数原型

```
inline half __hfma(half x, half y, half z)
```


```
inline bfloat16_t __hfma(bfloat16_t x, bfloat16_t y, bfloat16_t z)
```


#### 参数说明


**表1 参数说明**

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| x | 输入 | 源操作数。 |
| y | 输入 | 源操作数。 |
| z | 输入 | 源操作数。 |


#### 返回值说明

x * y+ z的值。

- x为±inf，y为±0，返回nan。
- x为±0，y为±inf，返回nan。
- x*y为inf，z为-inf，返回nan。
- x*y为-inf，z为inf，返回nan。
- x*y+z超出对应类型范围的最大值，返回inf。
- x*y+z小于对应类型范围的最小值，返回-inf。
- x、y、z任意一个为nan，返回nan。


#### 约束说明

SIMT编程场景当前不支持使用该接口。


#### 需要包含的头文件

使用half类型接口需要包含"simt_api/asc_fp16.h"头文件，使用bfloat16_t类型接口需要包含"simt_api/asc_bf16.h"头文件。

```
#include "simt_api/asc_fp16.h"
```

```
#include "simt_api/asc_bf16.h"
```


#### 调用示例

SIMD与SIMT混合编程场景：```
__simt_vf__ __launch_bounds__(1024) inline void KernelFma(__gm__ half* dst, __gm__ half* x, __gm__ half* y, __gm__ half* z){
    int idx = threadIdx.x + blockIdx.x * blockDim.x;
    dst[idx] = __hfma(x[idx], y[idx], z[idx]);
}
```