kev/Drawer/Module/GeoSigmaDraw/TsvParser.h

#pragma once
#include "stdafx.h"
#include <vector>
#include <map>

/**
 * @brief TSV（Tab分隔值）数据解析器
 * 
 * 独立的 TSV 解析工具类，可被其他模块复用
 * 负责将 TSV 格式的文本数据解析为结构化的表格数据
 */
class TsvParser
{
public:
	/**
	 * @brief 表格数据结构
	 * 
	 * 存储解析后的表格数据，包括列头和数据行
	 */
	struct TableData
	{
		std::vector<CString> headers;					// 列头
		std::vector<std::vector<CString>> rows;			// 数据行
		std::map<CString, int> columnIndexMap;			// 列名到索引的映射（不区分大小写）

		/**
		 * @brief 获取列索引
		 * @param columnName 列名（不区分大小写）
		 * @return 列索引，未找到返回 -1
		 */
		int GetColumnIndex(const CString& columnName) const;

		/**
		 * @brief 获取字段值
		 * @param row 行对象
		 * @param columnName 列名
		 * @return 字段值（已 Trim），未找到返回空字符串
		 */
		CString GetValue(const std::vector<CString>& row, const CString& columnName) const;

		/**
		 * @brief 获取字段值（按索引）
		 * @param row 行对象
		 * @param columnIndex 列索引
		 * @return 字段值（已 Trim），越界返回空字符串
		 */
		CString GetValue(const std::vector<CString>& row, int columnIndex) const;

		/**
		 * @brief 获取字段的 double 值
		 * @param row 行对象
		 * @param columnName 列名
		 * @param defaultValue 默认值（字段不存在或无法转换时使用）
		 * @return double 值
		 */
		double GetDoubleValue(const std::vector<CString>& row, const CString& columnName, double defaultValue = 0.0) const;

		/**
		 * @brief 是否为空表
		 */
		bool IsEmpty() const { return rows.empty(); }

		/**
		 * @brief 获取数据行数
		 */
		size_t GetRowCount() const { return rows.size(); }
	};

public:
	/**
	 * @brief 解析 TSV 数据
	 * @param tsvData TSV 格式的文本数据（第一行为列头，使用 Tab 分隔）
	 * @param outTableData 输出：解析后的表格数据
	 * @return 是否解析成功
	 */
	static bool Parse(const CString& tsvData, TableData& outTableData);

private:
	/**
	 * @brief 分割数据为行
	 * @param data 完整数据
	 * @param outLines 输出：行列表
	 */
	static void SplitLines(const CString& data, std::vector<CString>& outLines);

	/**
	 * @brief 解析单行 TSV 数据
	 * @param line 一行数据
	 * @param outFields 输出：字段列表
	 * @return 是否解析成功
	 */
	static bool ParseLine(const CString& line, std::vector<CString>& outFields);

	/**
	 * @brief 构建列名索引映射
	 * @param headers 列头列表
	 * @param outIndexMap 输出：列名到索引的映射
	 */
	static void BuildColumnIndexMap(const std::vector<CString>& headers, 
		std::map<CString, int>& outIndexMap);
};