RaggedRange
=================

为每个区间生成等差序列并拼接到一个一维输出，同时返回每段的边界索引。

.. math::

    \begin{aligned}
    L_k &= \left\lceil \frac{\text{limit}_k - \text{start}_k}{\text{delta}_k} \right\rceil,\quad k=0,\dots,\text{range\_count}-1 \\
    \text{splits}[0] &= 0,\quad \text{splits}[k+1] = \text{splits}[k] + L_k \\
    \text{values}[\text{splits}[k] + j] &= \text{start}_k + j \cdot \text{delta}_k,\quad j=0,\dots,L_k-1
    \end{aligned}

输入：
    - **starts** - 各段起始值数组地址。
    - **limits** - 各段终止上界数组地址（半开区间 [start, limit) 语义）。
    - **deltas** - 各段步长数组地址，要求 ``delta_k != 0``，且方向与 ``limit_k - start_k`` 一致，否则该段长度视为 0。
    - **range_count** - 段数 K。
    - **core_mask（可选）** - 核掩码（仅适用于共享存储版本）。

输出：
    - **values** - 扁平化拼接的结果数组地址，长度为 ``splits[range_count]``。
    - **splits** - 长度为 ``range_count + 1`` 的整型数组，记录各段边界，且 ``splits[0] = 0``。

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

.. note::
    - 当前实现覆盖 int8、int16、int32、fp32、fp64 五种类型。
    - 不进行数值饱和裁剪；请确保序列不会在对应类型范围内溢出。
    - 共享存储版本要求输入/输出地址位于共享可见的存储空间（如 GSM/DDR/SMC 等）。

**共享存储版本：**

.. c:function:: void i8_raggedrange_s(int8_t *starts, int8_t *limits, int8_t *deltas, int range_count, int8_t *values, int *splits, int core_mask)
.. c:function:: void i16_raggedrange_s(int16_t *starts, int16_t *limits, int16_t *deltas, int range_count, int16_t *values, int *splits, int core_mask)
.. c:function:: void i32_raggedrange_s(int32_t *starts, int32_t *limits, int32_t *deltas, int range_count, int32_t *values, int *splits, int core_mask)
.. c:function:: void fp_raggedrange_s(float *starts, float *limits, float *deltas, int range_count, float *values, int *splits, int core_mask)
.. c:function:: void dp_raggedrange_s(double *starts, double *limits, double *deltas, int range_count, double *values, int *splits, int core_mask)

    **C调用示例：**

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

        #include <stdio.h>
        #include <stdbool.h>
        
        int main(int argc, char* argv[]) {
            float *starts = (float *)0xA0000000;   // DDR
            float *limits = (float *)0xA0100000;   // DDR
            float *deltas = (float *)0xA0200000;   // DDR
            float *values = (float *)0xA0300000;   // DDR
            int   *splits = (int   *)0xA0400000;   // DDR
            int range_count = 3;
            int core_mask = 0xff;
            fp_raggedrange_s(starts, limits, deltas, range_count, values, splits, core_mask);
            return 0;
        }

**私有存储版本：**

.. c:function:: void i8_raggedrange_p(int8_t *starts, int8_t *limits, int8_t *deltas, int range_count, int8_t *values, int *splits)
.. c:function:: void i16_raggedrange_p(int16_t *starts, int16_t *limits, int16_t *deltas, int range_count, int16_t *values, int *splits)
.. c:function:: void i32_raggedrange_p(int32_t *starts, int32_t *limits, int32_t *deltas, int range_count, int32_t *values, int *splits)
.. c:function:: void fp_raggedrange_p(float *starts, float *limits, float *deltas, int range_count, float *values, int *splits)
.. c:function:: void dp_raggedrange_p(double *starts, double *limits, double *deltas, int range_count, double *values, int *splits)

    **C调用示例：**

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

        #include <stdio.h>
        
        int main(int argc, char* argv[]) {
            int32_t *starts = (int32_t *)0x10000000; // L2
            int32_t *limits = (int32_t *)0x10001000; // L2
            int32_t *deltas = (int32_t *)0x10002000; // L2
            int32_t *values = (int32_t *)0x10003000; // L2/DDR
            int     *splits = (int     *)0x10004000; // L2/DDR
            int range_count = 2;
            i32_raggedrange_p(starts, limits, deltas, range_count, values, splits);
            return 0;
        }
