计算向量每个元素的平方根。

计算公式为： $\text{[math]}$ 。

对于原址操作函数，计算公式为： $\text{[math]}$ 。

复数开方的计算公式为：

$\text{[math]}$ 。

函数接口声明如下：

浮点数的操作：
HmppResult HMPPS_Sqrt_32f(const float *src, float *dst, int32_t len);

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

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

HmppResult HMPPS_Sqrt_64fc(const Hmpp64fc *src, Hmpp64fc *dst, int32_t len);
整型数的缩放操作：
HmppResult HMPPS_Sqrt_8u_S(const uint8_t *src, uint16_t *dst, int32_t len, double scale);

HmppResult HMPPS_Sqrt_16u_S(const uint16_t *src, uint16_t *dst, int32_t len, double scale);

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

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

HmppResult HMPPS_Sqrt_16sc_S(const Hmpp16sc *src, Hmpp16sc *dst, int32_t len, double scale);
浮点数的原址操作：
HmppResult HMPPS_Sqrt_32f_I(float *srcDst, int32_t len);

HmppResult HMPPS_Sqrt_64f_I(double *srcDst, int32_t len);

HmppResult HMPPS_Sqrt_32fc_I(Hmpp32fc *srcDst, int32_t len);

HmppResult HMPPS_Sqrt_64fc_I(Hmpp64fc *srcDst, int32_t len);
整型数的原址缩放操作：
HmppResult HMPPS_Sqrt_8u_IS(uint8_t *srcDst, int32_t len, double scale);

HmppResult HMPPS_Sqrt_16u_IS(uint16_t *srcDst, int32_t len, double scale);

HmppResult HMPPS_Sqrt_16s_IS(int16_t *srcDst, int32_t len, double scale);

HmppResult HMPPS_Sqrt_16sc_IS(Hmpp16sc *srcDst, int32_t len, double scale);

参数

参数名	描述	取值范围	输入/输出
src	指向源向量的指针。	非空	输入
dst	指向目的向量的指针。	非空	输出
srcDst	指向原址操作向量的指针。	非空	输入/输出
len	向量长度。	(0,INT_MAX]	输入
scale	缩放因数。	(0,INF)且输入为2^n	输入

返回值

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

错误码

错误码	描述
HMPP_STS_NULL_PTR_ERR	src、dst、srcDst这几个入参中存在空指针。
HMPP_STS_SIZE_ERR	len小于或等于0。
HMPP_STS_SQRT_NEG_ARG	被开方的数为负数。
HMPP_STS_SCALE_ERR	scale不在(0,INF)范围内或输入为nan。

示例

#define  BUFFER_SIZE 10
void SqrtExample(void)
{
    float src[BUFFER_SIZE] = { 1.28, 4.53, 8.79, 4.23, 2.18, 9.69, 5.34, 8.03, 1.90, 8.76};
    float dst[BUFFER_SIZE] = { 0.00 };
    HmppResult result;
    int32_t i = 0;
    result = HMPPS_Sqrt_32f(src, dst, BUFFER_SIZE);
    printf("result = %d\n", result);
    if (result != HMPP_STS_NO_ERR) {
        return;
    }

    printf("dst = ");
    for(; i < BUFFER_SIZE; ++i){
        printf(" %.2f", dst[i]);
    }
    printf("\n");
}

运行结果：

result = 0
dst = 1.13 2.13 2.96 2.06 1.48 3.11 2.31 2.83 1.38 2.96