路径：支持库 → CSV支持库 → 表格文本。
硬约束
- 扁平命令；行/列索引从 0 起。默认分隔符
,；Tab 传"\t"。 - 创建/解析/读文件失败返回句柄
0；查CSV_取错误()。 - 用完必须
CSV_释放(句柄)。 - 大文件用
CSV_读文件/CSV_写文件，不要先整文件读文本再CSV_解析。 CSV_到文本行尾为\r\n。
快速开始
整数 t = CSV_创建()
整数 r = CSV_添加行(t)
CSV_置单元格(t, r, 0, "姓名")
CSV_置单元格(t, r, 1, "年龄")
r = CSV_添加行(t)
CSV_置行文本(t, r, "张三,20")
CSV_写文件(t, "out.csv")
CSV_释放(t)
表格文本
本分类共 17 条。
CSV_创建
- 签名：
整数 CSV_创建() - 说明：创建空表格，成功返回句柄（整数），失败返回 0。
CSV_解析
- 签名：
整数 CSV_解析(文本 CSV文本, [文本 分隔符=","]) - 说明：把 CSV 文本解析为表格，成功返回句柄。
- 参数一│CSV文本: 多行逗号分隔内容。
- 参数二│[分隔符]: 默认英文逗号；Tab 分隔写 “\t”。
CSV_读文件
- 签名：
整数 CSV_读文件(文本 文件路径, [文本 分隔符=","]) - 说明：极速 UTF-8：读取 CSV 文件并解析，成功返回句柄。
- 参数一│文件路径: 本地.csv 路径。
- 参数二│[分隔符]: 默认同 CSV_解析。
CSV_写文件
- 签名：
逻辑 CSV_写文件(整数 句柄, 文本 文件路径, [文本 分隔符=","]) - 说明：极速 UTF-8：把表格写入 CSV 文件；成功返回真。
- 参数一│句柄
- 参数二│文件路径
- 参数三│[分隔符]: 可省略。
CSV_取行数
- 签名：
整数 CSV_取行数(整数 句柄) - 说明：返回表格行数。
- 参数一│句柄
CSV_取列数
- 签名：
整数 CSV_取列数(整数 句柄) - 说明：返回最宽一行的列数。
- 参数一│句柄
CSV_取单元格
- 签名：
文本 CSV_取单元格(整数 句柄, 整数 行, 整数 列) - 说明：按行/列取单元格文本；越界返回空文本。
- 参数一│句柄
- 参数二│行: 从 0 起。
- 参数三│列: 从 0 起。
CSV_置单元格
- 签名：
逻辑 CSV_置单元格(整数 句柄, 整数 行, 整数 列, 文本 值) - 说明：写入单元格；行列不足时自动扩展；成功返回真。
- 参数一│句柄
- 参数二│行
- 参数三│列
- 参数四│值
CSV_添加行
- 签名：
整数 CSV_添加行(整数 句柄) - 说明：在表格末尾追加空行，返回新行索引（从 0 起）；失败返回 -1。
- 参数一│句柄
CSV_插入行
- 签名：
逻辑 CSV_插入行(整数 句柄, 整数 行) - 说明：在指定行位置插入空行；成功返回真。
- 参数一│句柄
- 参数二│行: 插入位置，从 0 起。
CSV_删除行
- 签名：
逻辑 CSV_删除行(整数 句柄, 整数 行) - 说明：删除指定行；成功返回真。
- 参数一│句柄
- 参数二│行
CSV_清空
- 签名：
逻辑 CSV_清空(整数 句柄) - 说明：清空表格全部行；成功返回真。
- 参数一│句柄
CSV_取行文本
- 签名：
文本 CSV_取行文本(整数 句柄, 整数 行) - 说明：取一整行的 CSV 文本（按当前分隔规则序列化）。
- 参数一│句柄
- 参数二│行
CSV_置行文本
- 签名：
逻辑 CSV_置行文本(整数 句柄, 整数 行, 文本 行内容) - 说明：用一行 CSV 文本覆盖指定行；成功返回真。
- 参数一│句柄
- 参数二│行
- 参数三│行内容: 如 “张三,20”。
CSV_到文本
- 签名：
文本 CSV_到文本(整数 句柄) - 说明：把表格序列化为 CSV 文本（Windows 换行 \r\n）。
- 参数一│句柄
CSV_释放
- 签名：
逻辑 CSV_释放(整数 句柄) - 说明：释放句柄；成功返回真。
- 参数一│句柄
CSV_取错误
- 签名：
文本 CSV_取错误() - 说明：取最近一次 CSV 操作失败原因。
易错对照
| 错误 | 正确 |
|---|---|
| 索引当从 1 | 从 0 起 |
| 忘记释放 | CSV_释放 |
| 大表先读成文本再解析 | 用 CSV_读文件 |