---
title: Threshold
description: "指定常数作为阈值，给向量中的元素做设阈操作。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0100.html
sourcePath: /source/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0100.html
indexId: 6c518a803bc0116bc21d035bb8c912c668279ce0a400c24f519ee847276eff5277
---
# Threshold

指定常数作为阈值，给向量中的元素做设阈操作。

接口中包含参数relOp，该参数指定了比较操作的类型，它的取值是HMPP_CMP_LT（小于）和HMPP_CMP_GT（大于）。

计算公式如下：

- 有实数序列src，且relOP = HMPP_CMP_LT，则
- 有实数序列src，且relOP = HMPP_CMP_GT，则
- 有复数序列src，且relOP = HMPP_CMP_LT，则
- 有复数序列src，且relOP = HMPP_CMP_GT，则

函数接口声明如下：

- 整型数的操作：
  HmppResult HMPPS_Threshold_16s(const int16_t* src, int16_t* dst, int32_t len, int16_t level, HmppCmpOp relOp);

- 浮点数的操作：
  HmppResult HMPPS_Threshold_32f(const float* src, float* dst, int32_t len, float level, HmppCmpOp relOp);

  HmppResult HMPPS_Threshold_64f(const double* src, double* dst, int32_t len, double level, HmppCmpOp relOp);

  HmppResult HMPPS_Threshold_32fc(const Hmpp32fc* src, Hmpp32fc* dst, int32_t len, float level, HmppCmpOp relOp);

- 整型数的原址操作：
  HmppResult HMPPS_Threshold_16s_I(int16_t* srcDst, int32_t len, int16_t level, HmppCmpOp relOp);

- 浮点数的原址操作：
  HmppResult HMPPS_Threshold_32f_I(float* srcDst, int32_t len, float level, HmppCmpOp relOp);

  HmppResult HMPPS_Threshold_64f_I(double* srcDst, int32_t len, double level, HmppCmpOp relOp);

  HmppResult HMPPS_Threshold_32fc_I(Hmpp32fc* srcDst, int32_t len, float level, HmppCmpOp relOp);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源向量的指针。 | 非空 | 输入 |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| srcDst | 指向原址操作向量的指针。 | 非空 | 输入/输出 |
| len | 向量长度。 | (0, INT\_MAX] | 输入 |
| level | 阈值。 | 不限，视类型而定 | 输入 |
| relOp | 运算模式。 | HMPP\_CMP\_LT、HMPP\_CMP\_GT | 输入 |


#### 返回值

- 成功：返回HMPP_STS_NO_ERR。
- 失败：返回错误码。


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src、dst、srcDst这几个入参中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | len小于或等于0。 |
| HMPP\_STS\_BAD\_ARG\_ERR | 运算模式错误。 |


#### 示例

```
#define BUFFER_SIZE_T 10
void ThresholdExample(void) {
float src[BUFFER_SIZE_T] = {-1.64, -1.63, -1.09, 0.71, 3.20,
-0.43, -0.41, 4.83,  5.36, 4.40};
float dst1[BUFFER_SIZE_T] = {0.00};
float dst2[BUFFER_SIZE_T] = {0.00};
HmppResult result;
result = HMPPS_Threshold_32f(src, dst1, BUFFER_SIZE_T, 3.14, HMPP_CMP_LT);
printf("Threshold1: result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
printf("dst1 =");
for (int i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %.2f", dst1[i]);
}
result = HMPPS_Threshold_32f(src, dst2, BUFFER_SIZE_T, 3.14, HMPP_CMP_GT);
printf("\nThreshold2: result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
printf("dst2 =");
for (int i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %.2f", dst2[i]);
}
printf("\n");
}
```

运行结果：

```
Threshold1: result = 0
dst1 = 3.14 3.14 3.14 3.14 3.20 3.14 3.14 4.83 5.36 4.40
Threshold2: result = 0
dst2 = -1.64 -1.63 -1.09 0.71 3.14 -0.43 -0.41 3.14 3.14 3.14
```