61 lines
1.8 KiB
C
61 lines
1.8 KiB
C
/**
|
|
* @file validation.h
|
|
* @brief 数据验证函数头文件
|
|
* @note 包含学生信息各字段的验证函数声明
|
|
*/
|
|
|
|
#ifndef VALIDATION_H
|
|
#define VALIDATION_H
|
|
|
|
#include <stdbool.h>
|
|
|
|
// 数据验证函数
|
|
|
|
/**
|
|
* @brief 验证成绩是否有效
|
|
* @details 检查成绩是否在有效范围内（0-100分）
|
|
* @param score 要验证的成绩值
|
|
* @return 如果成绩有效返回true，否则返回false
|
|
* @note 有效成绩范围为0.0到100.0（包含边界值）
|
|
*/
|
|
bool isValidScore(float score);
|
|
|
|
/**
|
|
* @brief 验证学号是否有效
|
|
* @details 检查学号格式是否符合要求：非空且长度在合理范围内
|
|
* @param id 要验证的学号字符串
|
|
* @return 如果学号有效返回true，否则返回false
|
|
* @note 学号不能为空，长度必须在1到MAX_ID_LENGTH之间
|
|
* @warning 如果id为NULL，返回false
|
|
*/
|
|
bool isValidStudentId(const char* id);
|
|
|
|
/**
|
|
* @brief 验证姓名是否有效
|
|
* @details 检查姓名格式是否符合要求：非空且长度在合理范围内
|
|
* @param name 要验证的姓名字符串
|
|
* @return 如果姓名有效返回true，否则返回false
|
|
* @note 姓名不能为空，长度必须在1到MAX_NAME_LENGTH之间
|
|
* @warning 如果name为NULL，返回false
|
|
*/
|
|
bool isValidName(const char* name);
|
|
|
|
/**
|
|
* @brief 验证性别是否有效
|
|
* @details 检查性别是否为'M'（男）或'F'（女）
|
|
* @param gender 要验证的性别字符
|
|
* @return 如果性别有效返回true，否则返回false
|
|
* @note 只接受'M'或'F'两个值
|
|
*/
|
|
bool isValidGender(char gender);
|
|
|
|
/**
|
|
* @brief 验证年龄是否有效
|
|
* @details 检查年龄是否在合理范围内
|
|
* @param age 要验证的年龄值
|
|
* @return 如果年龄有效返回true，否则返回false
|
|
* @note 有效年龄范围为MIN_AGE到MAX_AGE（包含边界值）
|
|
*/
|
|
bool isValidAge(int age);
|
|
|
|
#endif // VALIDATION_H
|