255 lines
7.2 KiB
C
255 lines
7.2 KiB
C
/**
|
||
* @file io_utils.c
|
||
* @brief 输入输出工具函数实现文件
|
||
* @note 实现界面显示、用户输入等相关函数
|
||
*/
|
||
|
||
#include <stdio.h>
|
||
#include <stdlib.h>
|
||
#include <string.h>
|
||
#include <ctype.h>
|
||
#ifdef _WIN32
|
||
#include <conio.h>
|
||
#endif
|
||
|
||
#include "io_utils.h"
|
||
#include "config.h"
|
||
#include "string_utils.h"
|
||
|
||
/**
|
||
* @brief 清理输入缓冲区
|
||
* @details 清除标准输入流中的所有剩余字符，直到遇到换行符或文件结束符
|
||
* 主要用于防止输入缓冲区中的残留字符影响后续输入操作
|
||
* @note 在使用scanf等函数后调用此函数可以避免输入问题
|
||
*/
|
||
void clearInputBuffer()
|
||
{
|
||
int c;
|
||
while ((c = getchar()) != '\n' && c != EOF)
|
||
;
|
||
}
|
||
|
||
/**
|
||
* @brief 暂停系统，等待用户按键
|
||
* @details 显示提示信息并等待用户按下任意键后继续执行
|
||
* 在Windows系统下使用_getch()函数，在其他系统下使用getchar()函数
|
||
* @note 用于在菜单操作完成后暂停，让用户有时间查看结果
|
||
* @warning 在非Windows系统下需要按回车键才能继续
|
||
*/
|
||
void pauseSystem()
|
||
{
|
||
printf("\n按任意键继续...");
|
||
#ifdef _WIN32
|
||
_getch();
|
||
#else
|
||
getchar();
|
||
#endif
|
||
printf("\n");
|
||
}
|
||
|
||
/**
|
||
* @brief 清屏
|
||
* @details 根据操作系统类型调用相应的清屏命令
|
||
* Windows系统使用"cls"命令，其他系统使用"clear"命令
|
||
* @note 用于清除终端屏幕内容，提供更好的用户界面体验
|
||
* @warning 依赖于系统命令，在某些受限环境下可能无法正常工作
|
||
*/
|
||
void clearScreen()
|
||
{
|
||
#ifdef _WIN32
|
||
system("cls");
|
||
#else
|
||
system("clear");
|
||
#endif
|
||
}
|
||
|
||
/**
|
||
* @brief 打印分隔线
|
||
* @details 输出一行由等号组成的分隔线，用于美化界面显示
|
||
* @note 分隔线长度为40个字符，用于分隔不同的界面区域
|
||
*/
|
||
void printSeparator()
|
||
{
|
||
printf("========================================\n");
|
||
}
|
||
|
||
/**
|
||
* @brief 打印标题头
|
||
* @details 以美观的格式显示标题，标题上下各有一条分隔线
|
||
* @param title 要显示的标题文本，不能为NULL
|
||
* @note 标题会居中显示，前面有10个空格的缩进
|
||
* @warning 如果title为NULL，可能导致程序崩溃
|
||
*/
|
||
void printHeader(const char *title)
|
||
{
|
||
printSeparator();
|
||
printf(" %s\n", title);
|
||
printSeparator();
|
||
}
|
||
|
||
/**
|
||
* @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)
|
||
{
|
||
int value;
|
||
char buffer[100];
|
||
|
||
while (1)
|
||
{
|
||
printf("%s (%d-%d): ", prompt, min, max);
|
||
|
||
if (fgets(buffer, sizeof(buffer), stdin) != NULL)
|
||
{
|
||
if (sscanf(buffer, "%d", &value) == 1)
|
||
{
|
||
if (value >= min && value <= max)
|
||
{
|
||
return value;
|
||
}
|
||
}
|
||
}
|
||
|
||
printError("输入无效，请重新输入！");
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @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)
|
||
{
|
||
float value;
|
||
char buffer[100];
|
||
|
||
while (1)
|
||
{
|
||
printf("%s (%.1f-%.1f): ", prompt, min, max);
|
||
|
||
if (fgets(buffer, sizeof(buffer), stdin) != NULL)
|
||
{
|
||
if (sscanf(buffer, "%f", &value) == 1)
|
||
{
|
||
if (value >= min && value <= max)
|
||
{
|
||
return value;
|
||
}
|
||
}
|
||
}
|
||
|
||
printError("输入无效，请重新输入！");
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @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)
|
||
{
|
||
while (1)
|
||
{
|
||
printf("%s: ", prompt);
|
||
|
||
if (fgets(buffer, maxLen, stdin) != NULL)
|
||
{
|
||
// 移除换行符
|
||
buffer[strcspn(buffer, "\n")] = '\0';
|
||
trimString(buffer);
|
||
|
||
if (!isEmptyString(buffer))
|
||
{
|
||
return;
|
||
}
|
||
}
|
||
|
||
printError("输入不能为空，请重新输入！");
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @brief 彩色输出
|
||
* @details 使用ANSI转义序列在终端中输出彩色文本
|
||
* 输出格式为：颜色代码 + 文本 + 重置代码
|
||
* @param text 要输出的文本内容
|
||
* @param color ANSI颜色代码字符串（如COLOR_RED、COLOR_GREEN等）
|
||
* @note 输出后会自动重置颜色为默认值
|
||
* @warning 如果终端不支持ANSI转义序列，可能显示乱码
|
||
*/
|
||
void printColored(const char *text, const char *color)
|
||
{
|
||
printf("%s%s%s", color, text, COLOR_RESET);
|
||
}
|
||
|
||
/**
|
||
* @brief 成功消息
|
||
* @details 以绿色显示成功消息，用于提示操作成功完成
|
||
* @param message 要显示的成功消息文本
|
||
* @note 消息会以绿色显示，并在末尾自动添加换行符
|
||
*/
|
||
void printSuccess(const char *message)
|
||
{
|
||
printColored(message, COLOR_GREEN);
|
||
printf("\n");
|
||
}
|
||
|
||
/**
|
||
* @brief 错误消息
|
||
* @details 以红色显示错误消息，用于提示操作失败或出现错误
|
||
* @param message 要显示的错误消息文本
|
||
* @note 消息会以红色显示，并在末尾自动添加换行符
|
||
*/
|
||
void printError(const char *message)
|
||
{
|
||
printColored(message, COLOR_RED);
|
||
printf("\n");
|
||
}
|
||
|
||
/**
|
||
* @brief 警告消息
|
||
* @details 以黄色显示警告消息，用于提示需要注意的情况
|
||
* @param message 要显示的警告消息文本
|
||
* @note 消息会以黄色显示，并在末尾自动添加换行符
|
||
*/
|
||
void printWarning(const char *message)
|
||
{
|
||
printColored(message, COLOR_YELLOW);
|
||
printf("\n");
|
||
}
|
||
|
||
/**
|
||
* @brief 信息消息
|
||
* @details 以青色显示信息消息，用于提示一般性信息
|
||
* @param message 要显示的信息消息文本
|
||
* @note 消息会以青色显示，并在末尾自动添加换行符
|
||
*/
|
||
void printInfo(const char *message)
|
||
{
|
||
printColored(message, COLOR_CYAN);
|
||
printf("\n");
|
||
} |