v4.1.0: 目录结构标准化 - 创建include/src目录分离头文件和源文件

2025-10-07 23:27:53 +08:00
parent 53964df405
commit 0894171ae0
39 changed files with 176 additions and 107 deletions
@@ -0,0 +1,36 @@
+/**
+ * @file student_io.h
+ * @brief 学生数据文件输入输出操作头文件
+ * @note 声明学生数据的文件读写、CSV解析等功能
+ */
+
+#ifndef STUDENT_IO_H
+#define STUDENT_IO_H
+
+#include "config.h"
+
+/**
+ * @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();
+
+#endif // STUDENT_IO_H