#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*/