DeepSeek V4.1 Flash
132b305544
基于 Win32 API + GDI+ 从零实现仿真数据检查器，用于替代 Simulink.sdi.view 查看带时间轴的 CSV 数据。 - 新增 Utilities 层：UTF-8/宽字符与数值格式化工具、CSV 解析器（自动识别分隔符与引号）、 信号数据集模型（时间轴识别、信号名解析、取值采样）、Solarised Light 主题色板与绘图基础工具 - 新增 Toolbar 组件：打开 CSV、适应窗口、适应时间、放大、缩小、合并网格、每信号一格 - 新增 SignalPanel 组件：信号列表（可见性开关、颜色标识、所属网格标记）、样式编辑区 （颜色、线宽、线段/散点/点线/阶梯显示方式、所属网格），支持右键上下文菜单与滚轮滚动 - 新增 PlotView 组件：多网格波形绘制、自适应时间轴与幅值轴、网格线、信号图例、 时间光标与实时数值读数、纵向滚动条 - 新增 Application 组件：DPI 感知（Per-Monitor V2）、双缓冲绘制、区域布局与分隔条拖拽、 鼠标与键盘消息分发、文件拖放、状态栏提示 - 交互能力：滚轮缩放、Shift+滚轮平移、Ctrl+滚轮缩放幅值、拖拽平移、幅值轴纵向缩放、 右键框选缩放、单击固定/取消时间光标、双击自适应、方向键平移与滚动 - 补齐 Makefile 的源文件与头文件索引，并新增 gdiplus、comdlg32 链接库
122 lines
4.0 KiB
C++
122 lines
4.0 KiB
C++
#ifndef __UTF8_UTIL_HPP__
|
|
#define __UTF8_UTIL_HPP__
|
|
|
|
#include <cstddef>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace jdi
|
|
{
|
|
|
|
/**
|
|
* @brief 将 UTF-8 编码的字节序列转换为宽字符串（UTF-16LE）。
|
|
* @param [IN] text UTF-8 文本起始地址。
|
|
* @param [IN] length 文本字节数，传入负值表示按 '\0' 结尾自动计算长度。
|
|
* @return 转换后的宽字符串，输入非法时返回空字符串。
|
|
*/
|
|
std::wstring Utf8ToWide(const char* text, int length = -1);
|
|
|
|
/**
|
|
* @brief 将宽字符串（UTF-16LE）转换为 UTF-8 编码的字节序列。
|
|
* @param [IN] text 宽字符文本起始地址。
|
|
* @return 转换后的 UTF-8 字符串，输入非法时返回空字符串。
|
|
*/
|
|
std::string WideToUtf8(const wchar_t* text);
|
|
|
|
/**
|
|
* @brief 去除字符串首尾的空白字符（含制表、换行与不间断空格）。
|
|
* @param [IN] text 待处理文本。
|
|
* @return 去除首尾空白后的新字符串。
|
|
*/
|
|
std::wstring Trim(const std::wstring& text);
|
|
|
|
/**
|
|
* @brief 去除字符串首尾的成对引号（单引号或双引号）。
|
|
* @param [IN] text 待处理文本。
|
|
* @return 去除引号后的新字符串。
|
|
*/
|
|
std::wstring StripQuotes(const std::wstring& text);
|
|
|
|
/**
|
|
* @brief 仅针对 ASCII 字母执行小写转换（其余字符原样保留）。
|
|
* @param [IN] text 待处理文本。
|
|
* @return 转换后的新字符串。
|
|
*/
|
|
std::wstring ToLowerAscii(const std::wstring& text);
|
|
|
|
/**
|
|
* @brief 判断字符串是否以指定前缀开头。
|
|
* @param [IN] text 被检索文本。
|
|
* @param [IN] prefix 前缀文本。
|
|
* @return 以该前缀开头返回 true，否则返回 false。
|
|
*/
|
|
bool StartsWith(const std::wstring& text, const std::wstring& prefix);
|
|
|
|
/**
|
|
* @brief 判断字符串是否包含指定子串（ASCII 大小写不敏感）。
|
|
* @param [IN] text 被检索文本。
|
|
* @param [IN] needle 子串文本。
|
|
* @return 包含返回 true，否则返回 false。
|
|
*/
|
|
bool ContainsInsensitive(const std::wstring& text, const std::wstring& needle);
|
|
|
|
/**
|
|
* @brief 从字符区间中解析一个双精度浮点数（允许尾部存在非数字残留字符）。
|
|
* @param [IN] begin 区间起始指针。
|
|
* @param [IN] end 区间结束指针（不包含）。
|
|
* @param [OUT] value 解析结果输出。
|
|
* @return 解析成功返回 true，区间为空或完全无法识别时返回 false。
|
|
*/
|
|
bool TryParseDouble(const char* begin, const char* end, double& value);
|
|
|
|
/**
|
|
* @brief 以固定小数位格式化数值。
|
|
* @param [IN] value 待格式化数值。
|
|
* @param [IN] decimals 小数位数。
|
|
* @return 格式化后的文本。
|
|
*/
|
|
std::wstring FormatNumber(double value, int decimals);
|
|
|
|
/**
|
|
* @brief 以自适应有效位格式化数值（NaN/Inf 会被转换为可读文本）。
|
|
* @param [IN] value 待格式化数值。
|
|
* @return 格式化后的文本。
|
|
*/
|
|
std::wstring FormatValue(double value);
|
|
|
|
/**
|
|
* @brief 依据坐标轴刻度步长格式化刻度标签。
|
|
* @param [IN] value 刻度值。
|
|
* @param [IN] step 刻度步长，用于推断所需小数位。
|
|
* @return 刻度标签文本。
|
|
*/
|
|
std::wstring FormatTick(double value, double step);
|
|
|
|
/**
|
|
* @brief 将整数格式化为带千位分隔符的文本。
|
|
* @param [IN] value 待格式化整数。
|
|
* @return 格式化后的文本。
|
|
*/
|
|
std::wstring FormatCount(unsigned long long value);
|
|
|
|
/**
|
|
* @brief 计算“美观”的坐标轴刻度步长（1/2/5 乘以 10 的整数次幂）。
|
|
* @param [IN] range 坐标轴数值跨度，必须为正数。
|
|
* @param [IN] targetTicks 期望的刻度数量。
|
|
* @return 刻度步长，输入非法时返回 1.0。
|
|
*/
|
|
double NiceStep(double range, int targetTicks);
|
|
|
|
/**
|
|
* @brief 依据范围与步长生成刻度值序列。
|
|
* @param [IN] minValue 范围下限。
|
|
* @param [IN] maxValue 范围上限。
|
|
* @param [IN] step 刻度步长。
|
|
* @param [OUT] ticks 输出刻度序列（按升序排列）。
|
|
*/
|
|
void BuildTicks(double minValue, double maxValue, double step, std::vector<double>& ticks);
|
|
|
|
} // namespace jdi
|
|
|
|
#endif // __UTF8_UTIL_HPP__
|