“shujbjiegouconggou”

io_utils.h

@@ -0,0 +1,144 @@
+/**
+ * @file io_utils.h
+ * @brief 输入输出工具函数头文件
+ * @note 包含界面显示、用户输入等相关函数声明
+ */
+
+#ifndef IO_UTILS_H
+#define IO_UTILS_H
+
+#include <stdbool.h>
+
+// 界面显示函数
+
+/**
+ * @brief 清理输入缓冲区
+ * @details 清除标准输入流中的所有剩余字符，直到遇到换行符或文件结束符
+ *          主要用于防止输入缓冲区中的残留字符影响后续输入操作
+ * @note 在使用scanf等函数后调用此函数可以避免输入问题
+ */
+void clearInputBuffer();
+
+/**
+ * @brief 暂停系统，等待用户按键
+ * @details 显示提示信息并等待用户按下任意键后继续执行
+ *          在Windows系统下使用_getch()函数，在其他系统下使用getchar()函数
+ * @note 用于在菜单操作完成后暂停，让用户有时间查看结果
+ * @warning 在非Windows系统下需要按回车键才能继续
+ */
+void pauseSystem();
+
+/**
+ * @brief 清屏
+ * @details 根据操作系统类型调用相应的清屏命令
+ *          Windows系统使用"cls"命令，其他系统使用"clear"命令
+ * @note 用于清除终端屏幕内容，提供更好的用户界面体验
+ * @warning 依赖于系统命令，在某些受限环境下可能无法正常工作
+ */
+void clearScreen();
+
+/**
+ * @brief 打印分隔线
+ * @details 输出一行由等号组成的分隔线，用于美化界面显示
+ * @note 分隔线长度为40个字符，用于分隔不同的界面区域
+ */
+void printSeparator();
+
+/**
+ * @brief 打印标题头
+ * @details 以美观的格式显示标题，标题上下各有一条分隔线
+ * @param title 要显示的标题文本，不能为NULL
+ * @note 标题会居中显示，前面有10个空格的缩进
+ * @warning 如果title为NULL，可能导致程序崩溃
+ */
+void printHeader(const char* title);
+
+// 安全输入函数
+
+/**
+ * @brief 安全输入整数
+ * @details 提供安全的整数输入功能，包含范围验证和错误处理
+ *          使用fgets和sscanf组合避免缓冲区溢出，循环直到获得有效输入
+ * @param prompt 显示给用户的提示信息
+ * @param min 允许输入的最小值（包含）
+ * @param max 允许输入的最大值（包含）
+ * @return 返回用户输入的有效整数
+ * @note 函数会一直循环直到用户输入有效的整数
+ * @note 自动显示输入范围提示
+ * @warning 如果prompt为NULL，printf可能出现问题
+ */
+int safeInputInt(const char* prompt, int min, int max);
+
+/**
+ * @brief 安全输入浮点数
+ * @details 提供安全的浮点数输入功能，包含范围验证和错误处理
+ *          使用fgets和sscanf组合避免缓冲区溢出，循环直到获得有效输入
+ * @param prompt 显示给用户的提示信息
+ * @param min 允许输入的最小值（包含）
+ * @param max 允许输入的最大值（包含）
+ * @return 返回用户输入的有效浮点数
+ * @note 函数会一直循环直到用户输入有效的浮点数
+ * @note 自动显示输入范围提示，精度为小数点后1位
+ * @warning 如果prompt为NULL，printf可能出现问题
+ */
+float safeInputFloat(const char* prompt, float min, float max);
+
+/**
+ * @brief 安全输入字符串
+ * @details 提供安全的字符串输入功能，包含空值检查和自动去除首尾空格
+ *          使用fgets避免缓冲区溢出，自动移除换行符并处理空白字符
+ * @param prompt 显示给用户的提示信息
+ * @param buffer 存储输入字符串的缓冲区
+ * @param maxLen 缓冲区的最大长度（包含终止符）
+ * @note 函数会一直循环直到用户输入非空字符串
+ * @note 自动移除输入字符串的首尾空白字符
+ * @warning 如果buffer为NULL或maxLen<=0，可能导致程序崩溃
+ */
+void safeInputString(const char* prompt, char* buffer, int maxLen);
+
+// 颜色输出函数
+
+/**
+ * @brief 彩色输出
+ * @details 使用ANSI转义序列在终端中输出彩色文本
+ *          输出格式为：颜色代码 + 文本 + 重置代码
+ * @param text 要输出的文本内容
+ * @param color ANSI颜色代码字符串（如COLOR_RED、COLOR_GREEN等）
+ * @note 输出后会自动重置颜色为默认值
+ * @warning 如果终端不支持ANSI转义序列，可能显示乱码
+ */
+void printColored(const char* text, const char* color);
+
+/**
+ * @brief 成功消息
+ * @details 以绿色显示成功消息，用于提示操作成功完成
+ * @param message 要显示的成功消息文本
+ * @note 消息会以绿色显示，并在末尾自动添加换行符
+ */
+void printSuccess(const char* message);
+
+/**
+ * @brief 错误消息
+ * @details 以红色显示错误消息，用于提示操作失败或出现错误
+ * @param message 要显示的错误消息文本
+ * @note 消息会以红色显示，并在末尾自动添加换行符
+ */
+void printError(const char* message);
+
+/**
+ * @brief 警告消息
+ * @details 以黄色显示警告消息，用于提示需要注意的情况
+ * @param message 要显示的警告消息文本
+ * @note 消息会以黄色显示，并在末尾自动添加换行符
+ */
+void printWarning(const char* message);
+
+/**
+ * @brief 信息消息
+ * @details 以青色显示信息消息，用于提示一般性信息
+ * @param message 要显示的信息消息文本
+ * @note 消息会以青色显示，并在末尾自动添加换行符
+ */
+void printInfo(const char* message);
+
+#endif // IO_UTILS_H