Add files via upload

2025-07-17 21:17:50 +08:00
parent ecdc668ae3
commit 4e240c6dc9
25 changed files with 1313 additions and 200 deletions
@@ -12,12 +12,24 @@
 /**
 * @brief 从CSV文件加载学生数据
 * @details 从STUDENTS_FILE指定的CSV文件中读取学生信息并加载到内存中
+ *          解析CSV格式数据，包括学号、姓名、年龄、性别、课程信息等
+ *          如果文件不存在，会初始化为空的学生列表
+ * @note 会跳过CSV文件的头部行，最多加载MAX_STUDENTS个学生
+ * @note 加载完成后会设置statsNeedUpdate标志为true
+ * @warning 如果CSV格式不正确，可能导致数据解析错误
+ * @see STUDENTS_FILE, MAX_STUDENTS, Student结构体
 */
 void loadStudentsFromFile();

 /**
 * @brief 将学生数据保存到CSV文件
 * @details 将内存中的所有学生数据以CSV格式保存到STUDENTS_FILE文件中
+ *          包含完整的CSV头部和所有学生的详细信息
+ *          保存成功后会重置dataModified标志
+ * @note CSV格式包括：学号、姓名、年龄、性别、课程数量、各课程名称和成绩、总分、平均分
+ * @note 对于课程数量不足MAX_COURSES的学生，会用空值填充
+ * @warning 如果文件无法创建或写入，会显示错误信息
+ * @see STUDENTS_FILE, MAX_COURSES, dataModified
 */
 void saveStudentsToFile();