slug: s2-01-ini title: INI支持库:便捷读写、句柄批处理、节键列表与删除 summary: 同时讲清 INI_写/INI_读 一行式,以及 INI_创建→置值→写文件→释放 的句柄流程;含节/键是否存在、取节列表、取键列表、删键删节。 tags: INI支持库,配置读写,句柄,节键 series: supportlib-s2 series_order: 1 type: tutorial
INI支持库:便捷读写、句柄批处理、节键列表与删除
面板:支持库 → INI支持库 → 配置读写(扁平)。
硬约束
- 写法 A(便捷):
INI_写/INI_读,内部自动开→读写→关。 - 写法 B(句柄):
INI_创建/INI_读文件→ 多次INI_置值/INI_取值→INI_写文件→ 必须INI_释放。 - 句柄失败返回
0,用INI_取错误()。 INI_取节列表/INI_取键列表返回文本数组。
窗口:按钮演示 编辑框日志
文本 g_文件 = ""
函数 写日志(文本 s) {
编辑框日志.文本 = 编辑框日志.文本 + s + 换行符
}
函数 主窗口.创建完毕() {
g_文件 = 取临时目录() + "\\ypp_s2.ini"
编辑框日志.文本 = "目标:" + g_文件
}
函数 按钮演示.单击(整数 X, 整数 Y) {
编辑框日志.文本 = ""
// ——— 写法 A:无句柄,单键读写 ———
INI_写(g_文件, "主", "名", "测试")
INI_写(g_文件, "主", "端口", "8080")
写日志("便捷读 名=" + INI_读(g_文件, "主", "名"))
写日志("便捷读 缺省=" + INI_读(g_文件, "主", "没有的键", "(默认)"))
// ——— 写法 B:句柄批量 ———
整数 h = INI_创建()
如果 (h == 0) {
写日志("创建失败:" + INI_取错误())
返回 ()
}
INI_置值(h, "数据库", "主机", "127.0.0.1")
INI_置值(h, "数据库", "库名", "demo")
INI_置值(h, "界面", "主题", "暗色")
如果 (INI_写文件(h, g_文件) == 假) {
写日志("写文件失败:" + INI_取错误())
INI_释放(h)
返回 ()
}
INI_释放(h)
写日志("句柄批写完成")
// 再读回
h = INI_读文件(g_文件)
如果 (h == 0) {
写日志("读文件失败:" + INI_取错误())
返回 ()
}
写日志("主机=" + INI_取值(h, "数据库", "主机"))
写日志("节存在 数据库=" + 到文本(INI_节是否存在(h, "数据库")))
写日志("键存在 主题=" + 到文本(INI_键是否存在(h, "界面", "主题")))
文本 节们[] = INI_取节列表(h)
文本 节 = ""
遍历 (节, 节们) {
写日志("[节] " + 节)
文本 键们[] = INI_取键列表(h, 节)
文本 键 = ""
遍历 (键, 键们) {
写日志(" " + 键 + "=" + INI_取值(h, 节, 键))
}
}
// 删除
INI_删键(h, "界面", "主题")
INI_删节(h, "主")
INI_写文件(h, g_文件)
写日志("已删键/删节并保存,剩余节数约=" + 到文本(取数组成员数(INI_取节列表(h))))
INI_释放(h)
写日志("—— 结束 ——")
}
对照:INI支持库