INI

读取 INI 整数

从 INI 文件的指定节和键中读取整数到 P/G/D/M/H 变量。

命令用途

Ini_Read_Integer 对应的实际命令写法是 INI_READ_INTEGER,用于从 INI 文件的指定节和键中读取整数到 P/G/D/M/H 变量。

它常见于读取统计值、次数、开关编号和需要继续参与数值判断的配置项。

命令名

Ini_Read_Integer

调用格式

INI_READ_INTEGER <文件路径> <节名> <键名> <变量>

参数说明

参数必填说明
文件路径是目标 INI 文件路径。
节名是要读取的节名称。
键名是要读取的键名称。
变量是用于接收结果的整数变量,应使用 P、G、D、M 或 H 变量。

返回或影响

  • 该命令会把指定键的整数值写入目标变量。
  • 它不是检查型命令,通常在读取后继续参与 #IF 判断、统计显示或运算流程。

示例

基础用法

#ACT
INI_READ_INTEGER .\Activity.ini Reward RewardCount P0

这段写法会从 Activity.ini 的 Reward 节中读取 RewardCount,并把结果写入 P0。

常见变体

#ACT
INI_READ_INTEGER 文件名 <$USERNAME> 某任务_物品名 P0

这类写法适合按当前角色名动态读取个人任务统计值。

注意事项

  • 当目标值是整数、次数、编号或统计量时,优先使用 INI_READ_INTEGER。
  • 如果读取的是名称、路径或说明文本,应改用 Ini_Read_String。

相关命令