Sqrt
=================

传入一个数组，对每个元素逐元素计算平方根并输出。

.. math::

    dst_i = \sqrt{src_i}

当输入值为负数时，结果为 NaN（符合 IEEE 浮点标准）。

输入：
    - **src_data** - 输入数据地址。
    - **length** - 计算长度。
    - **core_mask** - 核掩码（仅适用于共享存储版本）。

输出：
    - **dst_data** - 计算结果地址。

支持平台：
    ``FT78NE``
    ``MT7004``

.. note::
    - FT78NE 支持 fp, dp, int8, int16, int32, cplx64, cplx128
    - MT7004 支持 hp, fp, int16, int32, cplx64
    - 复数类型计算规则为：对复数模长取平方根并保持相位不变

**共享存储版本:**

.. c:function:: void i8_sqrt_s(int8_t* src_data, int8_t* dst_data, int length, int core_mask)
.. c:function:: void i16_sqrt_s(int16_t* src_data, int16_t* dst_data, int length, int core_mask)
.. c:function:: void i32_sqrt_s(int* src_data, int* dst_data, int length, int core_mask)
.. c:function:: void hp_sqrt_s(half* src_data, half* dst_data, int length, int core_mask)
.. c:function:: void fp_sqrt_s(float* src_data, float* dst_data, int length, int core_mask)
.. c:function:: void dp_sqrt_s(double* src_data, double* dst_data, int length, int core_mask)
.. c:function:: void c64_sqrt_s(float* src_data, float* dst_data, int length, int core_mask)
.. c:function:: void c128_sqrt_s(double* src_data, double* dst_data, int length, int core_mask)

**C调用示例：**

.. code-block:: c
    :linenos:
    :emphasize-lines: 10

    //FT78NE示例
    #include <stdio.h>
    #include <sqrt.h>

    int main(int argc, char* argv[]) {
        float *input = (float *)0xA0000000;
        float *output = (float *)0xC0000000;
        int length = 1024;
        int core_mask = 0xff;
        fp_sqrt_s(input, output, length, core_mask);
        return 0;
    }


**私有存储版本:**

.. c:function:: void i8_sqrt_p(int8_t* src_data, int8_t* dst_data, int length)
.. c:function:: void i16_sqrt_p(int16_t* src_data, int16_t* dst_data, int length)
.. c:function:: void i32_sqrt_p(int* src_data, int* dst_data, int length)
.. c:function:: void hp_sqrt_p(half* src_data, half* dst_data, int length)
.. c:function:: void fp_sqrt_p(float* src_data, float* dst_data, int length)
.. c:function:: void dp_sqrt_p(double* src_data, double* dst_data, int length)
.. c:function:: void c64_sqrt_p(float* src_data, float* dst_data, int length)
.. c:function:: void c128_sqrt_p(double* src_data, double* dst_data, int length)

**C调用示例：**

.. code-block:: c
    :linenos:
    :emphasize-lines: 9

    //FT78NE示例
    #include <stdio.h>
    #include <sqrt.h>

    int main(int argc, char* argv[]) {
        float *input = (float *)0x10810000;
        float *output = (float *)0x10820000;
        int length = 1024;
        fp_sqrt_p(input, output, length);
        return 0;
    }
