YStudio Y++

INI支持库:便捷读写、句柄批处理、节键列表与删除

Y++ / YStudio 开发文档 · 一点滴


slug: s2-01-ini title: INI支持库:便捷读写、句柄批处理、节键列表与删除 summary: 同时讲清 INI_写/INI_读 一行式,以及 INI_创建→置值→写文件→释放 的句柄流程;含节/键是否存在、取节列表、取键列表、删键删节。 tags: INI支持库,配置读写,句柄,节键 series: supportlib-s2 series_order: 1 type: tutorial


INI支持库:便捷读写、句柄批处理、节键列表与删除

面板:支持库 → INI支持库 → 配置读写(扁平)。

硬约束

  1. 写法 A(便捷):INI_写 / INI_读,内部自动开→读写→关。
  2. 写法 B(句柄):INI_创建 / INI_读文件 → 多次 INI_置值/INI_取值 → INI_写文件 → 必须 INI_释放。
  3. 句柄失败返回 0,用 INI_取错误()。
  4. 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支持库