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::
    - FT78NE 支持 int8, int16, int32, fp32, fp64
    - MT7004 支持 fp16, fp32, int16, int32
    - 不进行数值饱和裁剪；请确保序列不会在对应类型范围内溢出。

**共享存储版本：**

.. c:function:: void i8_ragged_range_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_ragged_range_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_ragged_range_s(int *starts, int *limits, int *deltas, int range_count, int *values, int *splits, int core_mask)
.. c:function:: void hp_ragged_range_s(half *starts, half *limits, half *deltas, int range_count, half *values, int *splits, int core_mask)
.. c:function:: void fp_ragged_range_s(float *starts, float *limits, float *deltas, int range_count, float *values, int *splits, int core_mask)
.. c:function:: void dp_ragged_range_s(double *starts, double *limits, double *deltas, int range_count, double *values, int *splits, int core_mask)

**C调用示例：**

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

    #include <stdio.h>

    int main(int argc, char* argv[]) {
        float *starts = (float *)0xA0000000;
        float *limits = (float *)0xA0100000;
        float *deltas = (float *)0xA0200000;
        float *values = (float *)0xA0300000;
        int   *splits = (int   *)0xA0400000;
        int range_count = 3;
        int core_mask = 0xff;
        fp_ragged_range_s(starts, limits, deltas, range_count, values, splits, core_mask);
        return 0;
    }

**私有存储版本：**

.. c:function:: void i8_ragged_range_p(int8_t *starts, int8_t *limits, int8_t *deltas, int range_count, int8_t *values, int *splits)
.. c:function:: void i16_ragged_range_p(int16_t *starts, int16_t *limits, int16_t *deltas, int range_count, int16_t *values, int *splits)
.. c:function:: void i32_ragged_range_p(int *starts, int *limits, int *deltas, int range_count, int *values, int *splits)
.. c:function:: void hp_ragged_range_p(half *starts, half *limits, half *deltas, int range_count, half *values, int *splits)
.. c:function:: void fp_ragged_range_p(float *starts, float *limits, float *deltas, int range_count, float *values, int *splits)
.. c:function:: void dp_ragged_range_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;
        int32_t *limits = (int32_t *)0x10001000;
        int32_t *deltas = (int32_t *)0x10002000;
        int32_t *values = (int32_t *)0x10003000;
        int     *splits = (int     *)0x10004000;
        int range_count = 2;
        i32_ragged_range_p(starts, limits, deltas, range_count, values, splits);
        return 0;
    }
