路径：支持库 → INI支持库 → 配置读写。
硬约束
- 扁平命令；无
INI_解析；内存态用句柄，单次读写文件用INI_读/INI_写。 INI_创建/INI_读文件失败返回句柄0；查INI_取错误()。- 句柄用完必须
INI_释放。 INI_取节列表/INI_取键列表返回 文本数组。- 大文件用
INI_读文件/INI_写文件（UTF-8 极速路径）。
快速开始
整数 h = INI_创建()
INI_置值(h, "主", "名", "测试")
INI_写文件(h, "cfg.ini")
INI_释放(h)
h = INI_读文件("cfg.ini")
输出(INI_取值(h, "主", "名"))
INI_释放(h)
// 无句柄便捷
INI_写("cfg.ini", "主", "名", "测试")
输出(INI_读("cfg.ini", "主", "名"))
配置读写
本分类共 15 条。
INI_创建
- 签名：
整数 INI_创建() - 说明：创建空 INI 文档，成功返回句柄。
INI_读文件
- 签名：
整数 INI_读文件(文本 文件路径) - 说明：极速读取 UTF-8 INI 文件，成功返回句柄。
- 参数一│文件路径
INI_写文件
- 签名：
逻辑 INI_写文件(整数 句柄, 文本 文件路径) - 说明：极速写入 UTF-8 INI 文件。
- 参数一│句柄
- 参数二│文件路径
INI_取值
- 签名：
文本 INI_取值(整数 句柄, 文本 节, 文本 键, [文本 默认=""]) - 说明：取键值；不存在返回默认。
- 参数一│句柄
- 参数二│节
- 参数三│键
- 参数四│[默认]
INI_置值
- 签名：
逻辑 INI_置值(整数 句柄, 文本 节, 文本 键, 文本 值) - 说明：设置键值（节/键不存在则创建）。
- 参数一│句柄
- 参数二│节
- 参数三│键
- 参数四│值
INI_删键
- 签名：
逻辑 INI_删键(整数 句柄, 文本 节, 文本 键) - 说明：删除键。
- 参数一│句柄
- 参数二│节
- 参数三│键
INI_删节
- 签名：
逻辑 INI_删节(整数 句柄, 文本 节) - 说明：删除整个节。
- 参数一│句柄
- 参数二│节
INI_节是否存在
- 签名：
逻辑 INI_节是否存在(整数 句柄, 文本 节) - 说明：节是否存在。
- 参数一│句柄
- 参数二│节
INI_键是否存在
- 签名：
逻辑 INI_键是否存在(整数 句柄, 文本 节, 文本 键) - 说明：键是否存在。
- 参数一│句柄
- 参数二│节
- 参数三│键
INI_取节列表
- 签名：
文本数组 INI_取节列表(整数 句柄) - 说明：返回全部节名（文本数组）。
- 参数一│句柄
INI_取键列表
- 签名：
文本数组 INI_取键列表(整数 句柄, 文本 节) - 说明：返回指定节下全部键名（文本数组）。
- 参数一│句柄
- 参数二│节
INI_读
- 签名：
文本 INI_读(文本 文件路径, 文本 节, 文本 键, [文本 默认=""]) - 说明：便捷：直接从文件读一个键（内部打开→取值→关闭）。
- 参数一│文件路径
- 参数二│节
- 参数三│键
- 参数四│[默认]
INI_写
- 签名：
逻辑 INI_写(文本 文件路径, 文本 节, 文本 键, 文本 值) - 说明：便捷：直接写入文件一个键（缺文件则创建）。
- 参数一│文件路径
- 参数二│节
- 参数三│键
- 参数四│值
INI_释放
- 签名：
逻辑 INI_释放(整数 句柄) - 说明：释放句柄。
- 参数一│句柄
INI_取错误
- 签名：
文本 INI_取错误() - 说明：取最近失败原因。
易错对照
| 错误 | 正确 |
|---|---|
| 忘记释放句柄 | INI_释放 |
| 大文件反复 INI_读 | 用句柄 INI_读文件 一次加载 |