String

String/c_LSD.h

@@ -0,0 +1,42 @@
+#ifndef INCLUDED_C_LSD_H
+#define INCLUDED_C_LSD_H
+
+#ifndef INCLUDED_C_TYPES_H
+#include <c_Types.h>
+#endif /*INCLUDED_C_TYPES_H*/
+
+#ifndef INCLUDED_C_ALLOCATOR_H
+#include <c_Allocator.h>
+#endif /*INCLUDED_C_ALLOCATOR_H*/
+
+
+/* ------------------------------------------------------------------------------------------------------------------ */
+/*  */
+
+/**
+ * @brief 泛型 LSD 专用字节密钥提取器函数指针
+ *
+ * @param elem 指向当前泛型待提取对象的指针
+ * @param d    当前从低向高扫描的第 d 个字节下标位置（0 代表最低位字节，W-1 代表最高位字节）
+ * @param args 自定义上下文参数指针
+ * @return uint8_t 返回该泛型对象在第 d 个字节处的物理 8 位无符号整型键值 [0, 255]
+ */
+typedef uint8_t (*c_LSD_ExtractorFn)(const void* elem, c_size_t d, void* args);
+
+
+/**
+ * @brief 工业级泛型低位优先（LSD）基数排序核心接口（分配器内联组合版）
+ *
+ * @param base      指向待排序连续数组首元素的指针
+ * @param num       数组中元素的总个数 (N)
+ * @param elem_size 单个泛型元素对象占用的字节体量 (sizeof)
+ * @param w_bytes   该泛型对象的排序密钥的总定长字节宽度 (W)
+ * @param extractor 字节提取器回调虚操作函数指针 (不能为 NULL)
+ * @param args      自定义上下文参数指针
+ * @param allocator 用户自制的分配器指针（传入 NULL 则自动降级调用 c_DefaultAllocator）
+ */
+c_err_t c_LSD_RadixSort(void* base, c_size_t num, c_size_t elem_size, c_size_t w_bytes,
+    c_LSD_ExtractorFn extractor, void* args, c_Allocator_t* allocator);
+
+
+#endif /*INCLUDED_C_LSD_H*/