Cast
=================



对输入数组进行 **逐元素数据类型转换（Cast）**，将源类型的数据按 C 语言强制类型转换规则转换为目标类型后输出。

数学表达式为：

.. math::

    dst_i = (T_{dst}) \; src_i

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

输出：
    - **output** - 转换后的结果数据地址。

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

.. note::
    - FT78NE 支持 ``fp32``、``fp64``、``int8``、``int16``、``int32``、``cplx64``、``cplx128`` 类型之间的 Cast
    - MT7004 支持 ``fp16``、``fp32``、``int16``、``int32``、``cplx64`` 类型之间的 Cast
    - 转换规则遵循 C 语言显式类型转换语义，可能存在精度截断或溢出风险
    - 输入与输出张量长度必须一致

**共享存储版本:**

.. c:function:: void casti8Tointi8_s(int8_t* input, int8_t* output, int length, int core_mask)
.. c:function:: void casti8Tointi16_s(int8_t* input, int16_t* output, int length, int core_mask)
.. c:function:: void casti8Tointi32_s(int8_t* input, int32_t* output, int length, int core_mask)
.. c:function:: void casti8Tofp_s(int8_t* input, float* output, int length, int core_mask)

.. c:function:: void casti16Tointi8_s(int16_t* input, int8_t* output, int length, int core_mask)
.. c:function:: void casti16Tointi16_s(int16_t* input, int16_t* output, int length, int core_mask)
.. c:function:: void casti16Tointi32_s(int16_t* input, int32_t* output, int length, int core_mask)
.. c:function:: void casti16Tofp_s(int16_t* input, float* output, int length, int core_mask)

.. c:function:: void casti32Tointi8_s(int32_t* input, int8_t* output, int length, int core_mask)
.. c:function:: void casti32Tointi16_s(int32_t* input, int16_t* output, int length, int core_mask)
.. c:function:: void casti32Tointi32_s(int32_t* input, int32_t* output, int length, int core_mask)
.. c:function:: void casti32Tofp_s(int32_t* input, float* output, int length, int core_mask)

.. c:function:: void castfpTofp_s(float* input, float* output, int length, int core_mask)
.. c:function:: void castfpToint8_s(float* input, int8_t* output, int length, int core_mask)
.. c:function:: void castfpToint16_s(float* input, int16_t* output, int length, int core_mask)
.. c:function:: void castfpToint32_s(float* input, int32_t* output, int length, int core_mask)

.. c:function:: void castdpTodp_s(double* input, double* output, int length, int core_mask)
.. c:function:: void castdpTofp_s(double* input, float* output, int length, int core_mask)

.. c:function:: void castc64Toc64_s(cplx64* input, cplx64* output, int length, int core_mask)
.. c:function:: void castc128Toc128_s(cplx128* input, cplx128* output, int length, int core_mask)

**C调用示例：**

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

    // FT78NE 示例：int8 -> int16
    #include <stdio.h>
    #include <cast.h>

    int main(int argc, char* argv[]) {
        int8_t *input = (int8_t *)0xA0000000;
        int16_t *output = (int16_t *)0xC0000000;

        int length = 2048;
        int core_mask = 0xff;

        casti8Tointi16_s(input, output, length, core_mask);
        return 0;
    }


**私有存储版本:**

.. c:function:: void casti8Tointi8_p(int8_t* input, int8_t* output, int length)
.. c:function:: void casti8Tointi16_p(int8_t* input, int16_t* output, int length)
.. c:function:: void casti8Tointi32_p(int8_t* input, int32_t* output, int length)
.. c:function:: void casti8Tofp_p(int8_t* input, float* output, int length)

.. c:function:: void casti16Tointi8_p(int16_t* input, int8_t* output, int length)
.. c:function:: void casti16Tointi16_p(int16_t* input, int16_t* output, int length)
.. c:function:: void casti16Tointi32_p(int16_t* input, int32_t* output, int length)
.. c:function:: void casti16Tofp_p(int16_t* input, float* output, int length)

.. c:function:: void casti32Tointi8_p(int32_t* input, int8_t* output, int length)
.. c:function:: void casti32Tointi16_p(int32_t* input, int16_t* output, int length)
.. c:function:: void casti32Tointi32_p(int32_t* input, int32_t* output, int length)
.. c:function:: void casti32Tofp_p(int32_t* input, float* output, int length)

.. c:function:: void castfpTofp_p(float* input, float* output, int length)
.. c:function:: void castfpToint8_p(float* input, int8_t* output, int length)
.. c:function:: void castfpToint16_p(float* input, int16_t* output, int length)
.. c:function:: void castfpToint32_p(float* input, int32_t* output, int length)

.. c:function:: void castdpTodp_p(double* input, double* output, int length)
.. c:function:: void castdpTofp_p(double* input, float* output, int length)

.. c:function:: void castc64Toc64_p(cplx64* input, cplx64* output, int length)
.. c:function:: void castc128Toc128_p(cplx128* input, cplx128* output, int length)


**C调用示例：**

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

    // FT78NE 示例：int8 -> int16（私有存储）
    #include <stdio.h>
    #include <cast.h>

    int main(int argc, char* argv[]) {
        int8_t *input = (int8_t *)0x10810000;
        int16_t *output = (int16_t *)0x10820000;

        int length = 2048;
        casti8Tointi16_p(input, output, length);
        return 0;
    }
