996PC 字符分割GETVALIDSTRSUPER命令用法

GETVALIDSTRSUPER 是996PC引擎里用于字符串分割的命令支持把分割结果批量存入带序号的临时变量，并可选返回分割数量。

命令格式

GETVALIDSTRSUPER 参数1 参数2 参数3 参数4(可空)

• 参数1：待分割的字符串，内容之间用分隔符连接，例如 内容A:内容B:内容C
• 参数2：分隔符，例如 : 或 |
• 参数3：存入的变量名前缀，支持临时变量 N$XX、S$XX，序号范围支持到9999。分割后第1段存入 S$变量1，第2段存入 S$变量2，依此类推。
• 参数4（可空）：将分割总数量存入该变量，不需要时可省略。

使用示例：从文件读取装备列表并分发给玩家

场景：装备列表.txt 里存了一行装备数据，用冒号分隔：

战神盔甲(男):裁决之杖:绿色项链:黑铁头盔:骑士手镯:骑士手镯:力量戒指:力量戒指

脚本逻辑如下：

[@分割]
#IF
gender man
checkjob warrior
#ACT
GetRandomText ..QuestDiary装备列表.txt <$STR(S$装备数据)> 0
GETVALIDSTRSUPER <$STR(S$装备数据)> : S$变量
GIVE <$STR(S$变量1)> 1
GIVE <$STR(S$变量2)> 1
GIVE <$STR(S$变量3)> 1
GIVE <$STR(S$变量4)> 1
GIVE <$STR(S$变量5)> 1
GIVE <$STR(S$变量6)> 1
GIVE <$STR(S$变量7)> 1
GIVE <$STR(S$变量8)> 1
TakeOn <$STR(S$变量1)> 0
TakeOn <$STR(S$变量2)> 1
TakeOn <$STR(S$变量3)> 3
TakeOn <$STR(S$变量4)> 4
TakeOn <$STR(S$变量5)> 5
TakeOn <$STR(S$变量6)> 6
TakeOn <$STR(S$变量7)> 7
TakeOn <$STR(S$变量8)> 8
BREAK

执行后，GETVALIDSTRSUPER 把8段装备名分别存入 S$变量1 到 S$变量8，后续 GIVE 和 TakeOn 直接引用对应变量即可，不需要手动一个个解析。

注意事项

• 变量名前缀不要带数字结尾，否则序号会和前缀拼接产生歧义。例如前缀用 S$变量，分割后生成 S$变量1、S$变量2……
• 参数3只支持临时变量（N$ 或 S$），不支持全局变量。
• 参数4如果填了变量名，会把本次分割的段数写进去，方便后续按数量循环处理。