C语言通过\_Generic宏实现编译期函数重载，支持类型安全、零开销的多态调用；也可用统一函数+运行时类型标签或命名规范+共享结构体适配不同输入源。
函数重载本身不是C语言的原生能力，但“模拟重载”是构建通用库接口的关键设计思路。核心目标不是让编译器自动分发调用，而是让使用者面对同一函数名、不同参数时，获得类型安全、语义清晰、无需记忆多个函数名的体验。
用宏+类型推导实现轻量级重载（推荐用于C项目）
这是最贴近C语言风格且无运行时开销的方式。关键在于利用__typeof__（GCC/Clang扩展）或_Generic（C11标准）做编译期类型选择：
-
_Generic 是首选：它在编译期根据实参类型匹配分支，零成本、可移植（C11+）。例如实现一个通用的
max接口：
#define max(a, b) _Generic((a), \
int: max_int, \
float: max_float, \
double: max_double \
)(a, b)
static inline int max_int(int x, int y) { return x > y ? x : y; }
static inline float max_float(float x, float y) { return x > y ? x : y; }
static inline double max_double(double x, double y) { return x > y ? x : y; }
- 调用
max(3, 5)走max_int，max(3.14f, 2.71f)走max_float，语义明确，无强制转换风险。 - 支持自定义类型：只要为结构体提供比较函数，就能扩展
_Generic分支。
用统一函数+运行时类型检查实现灵活重载（适合跨类型逻辑复杂场景）
当不同类型的操作逻辑差异大，或需支持用户自定义类型时，可封装一个入口函数，内部用enum或类型标签区分行为：
- 定义统一签名，如
status_t lib_process(const void *data, size_t len, data_type_t type)； -
data_type_t枚举涵盖TYPE_INT32、TYPE_FLOAT64、TYPE_STRING等； - 内部用
switch(type)分发到对应处理函数，避免宏膨胀，也便于调试和日志追踪。
借鉴rnnoise的“多函数名 + 共享结构体”模式（强调可维护性）
像rnnoise_model_from_buffer、rnnoise_model_from_file这类命名，表面看是多个函数，实则共享RNNModel结构体和大部分逻辑：
- 每个函数只负责“输入适配”：把缓冲区、文件指针、路径字符串转成统一内存布局；
- 后续所有处理（如推理、释放）都操作同一结构体，不关心数据来源；
- 对使用者友好：名字直白，IDE能提示，不依赖编译器扩展，兼容所有C标准。
避免踩坑的关键细节
模拟重载容易引入隐晦问题，需特别注意：
- 别仅靠返回值区分：C语言不支持仅返回类型不同的重载，编译器无法识别；
-
慎用可变参数宏检测参数个数：
sizeof((int[]){__VA_ARGS__})在空参数或含逗号表达式时可能出错，_Generic更可靠； -
类型别名要显式覆盖：若用
typedef int my_int，_Generic中需单独写my_int: ...，否则默认匹配int分支； -
浮点类型精度要分开处理：
float、double、long double必须作为独立分支，混用会导致精度丢失或未定义行为。
