更新MD文件路径引用

- 修正主README.md中的所有路径引用，使其与当前文件结构一致 - 更新翁凯C语言学习指南链接路径 - 更新五子棋AI项目文档链接路径 - 更新数据结构学习文档链接路径 - 修正编译说明和学习模块使用指南中的目录路径 - 改进五子棋README.md的编译运行说明，增加Windows和Linux/macOS的分平台指导 - 确保所有文档链接和路径引用都能正确工作
2025-10-17 10:52:27 +08:00
parent e691ab43cc
commit 93c16edb5a
183 changed files with 11 additions and 11 deletions
@@ -0,0 +1,22 @@
+/**
+ * @file math_utils.h
+ * @brief 数学计算工具函数头文件
+ * @note 包含数学计算相关函数声明
+ */
+
+#ifndef MATH_UTILS_H
+#define MATH_UTILS_H
+
+/**
+ * @brief 计算平均值
+ * @details 计算浮点数数组的算术平均值
+ *          遍历数组求和，然后除以元素个数
+ * @param scores 浮点数数组
+ * @param count 数组元素个数
+ * @return 返回数组的平均值，如果count为0返回0.0
+ * @note 如果count为0，函数返回0.0避免除零错误
+ * @warning 如果scores为NULL且count>0，可能导致程序崩溃
+ */
+float calculateAverage(float scores[], int count);
+
+#endif // MATH_UTILS_H