---
title: Phase
description: "求给定复数向量的相位角。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0157.html
sourcePath: /source/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0157.html
indexId: 1815f8615b35af128d12a218df0f34ca10744b1b400c3dc3bfd54d4373f4ed1b77
---
# Phase

求给定复数向量的相位角。

函数接口声明如下：

- 整型数的操作：
  HmppResult HMPPS_Phase_16s32f(const int16_t* srcRe, const int16_t* srcIm, float* dst, int32_t len);

  HmppResult HMPPS_Phase_16sc32f(const Hmpp16sc* src, float* dst, int32_t len);

  HmppResult HMPPS_Phase_16s_S(const int16_t* srcRe, const int16_t* srcIm, int16_t* dst, int32_t len, double scale);

  HmppResult HMPPS_Phase_16sc_S(const Hmpp16sc* src, int16_t* dst, int32_t len, double scale);

- 浮点数的操作：
  HmppResult HMPPS_Phase_32f(const float* srcRe, const float* srcIm, float* dst, int32_t len);

  HmppResult HMPPS_Phase_64f(const double* srcRe, const double* srcIm, double* dst, int32_t len);

  HmppResult HMPPS_Phase_32fc(const Hmpp32fc* src, float* dst, int32_t len);

  HmppResult HMPPS_Phase_64fc(const Hmpp64fc* src, double* dst, int32_t len);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| len | 向量长度。 | (0,INT\_MAX] | 输入 |
| src | 指向复数向量序列的指针。 | 视类型而定 | 输入 |
| srcRe | 指向复数实部向量序列的指针。 | 视类型而定 | 输入 |
| srcIm | 指向复数虚部向量序列的指针。 | 视类型而定 | 输入 |
| scale | 缩放因数。 | (0,INF)且输入为2^n | 输入 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | dst这个入参中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | len小于或等于0。 |
| HMPP\_STS\_SCALE\_ERR | scale不在(0,INF)范围内或输入为nan。 |


#### 示例

```
#define BUFFER_SIZE_T 10
int main()
{
double dst[BUFFER_SIZE_T];
int32_t i;
double src1[BUFFER_SIZE_T] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
double src2[BUFFER_SIZE_T] = {41.7918, 171.61, 55.8247, 85.8605, 93.5198, 275.385, 229.065, 302.278, 64.373, 309.137};
HmppResult result = HMPPS_Phase_64f(src1, src2, dst, BUFFER_SIZE_T);
printf("result = %d \ndst =", result);
for (i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %f    ", dst[i]);
}
return 0;
}
```

运行结果：

```
result = 0
dst = 1.570796     1.564969     1.534985     1.535870     1.528051     1.552642     1.544609     1.547643     1.447155     1.541691
```