ESP脚本列表元素变量基础操作教程(赋值/增删改查)

本文详细讲解ESP脚本中列表元素变量的全套基础操作，包含变量赋值、元素截取、子元素修改、新增、删除、位置查询、数量统计、元素校验以及变量下标调用等实用功能，附带完整可运行代码示例，适合新手学习参考，可直接复制测试使用。
一、列表元素变量赋值(基础赋值)
ESP脚本中给列表元素变量赋值时，非子元素的赋值内容必须用中括号 [] 包裹，否则会出现代码报错，这是列表变量赋值的核心规范。
二、列表元素截取操作
脚本支持通过下标截取列表元素，下标规则：下标≥0 从列表首位向后取值，下标＜0 从列表末尾向前取值，可精准获取指定位置的单个元素。
;-----------------------------------------[取各字元素(大于等于0从第一个往后取；小于0从最后一个往前取]
sendmsg 7 输出结果：<$str(L$测试[0])>,<$str(L$测试[1])>,<$str(L$测试[2])>,,,,,<$str(L$测试[-2])>,<$str(L$测试[-1])>,
;输出结果：11,22,33,,,,,77,aa,
三、列表子元素修改操作
可直接通过指定下标，精准替换列表中对应位置的子元素，修改后列表其余元素保持不变，仅目标下标元素更新。
;-----------------------------------------[修改子元素]
MOV L$测试[0] 00
sendmsg 7 输出结果：<$str(L$测试)>
;输出结果：[00,22,33,44,55,66,77,aa]
四、列表子元素新增操作
使用 INC 指令可快速为列表变量尾部新增子元素，无需固定下标，自动追加至列表末尾，操作简单便捷。
;-----------------------------------------[增加子元素]
INC L$测试 bb
sendmsg 7 输出结果：<$str(L$测试)>
;输出结果：[00,22,33,44,55,66,77,aa,bb]
五、列表子元素删除操作
通过 Dec 指令可精准删除列表中指定内容的子元素，匹配到对应元素后直接移除，列表自动补位排序。
;-----------------------------------------[删除子元素]
Dec L$测试 22
sendmsg 7 输出结果：<$str(L$测试)>
;输出结果：[00,33,44,55,66,77,aa,bb]
六、列表嵌套子元素修改
ESP脚本支持列表嵌套功能，可将完整列表变量赋值给另一个列表的子元素，实现多维列表数据存储与修改。
;-----------------------------------------[修改子元素]
Mov L$测试2 [aa,bb,cc]
Mov L$测试[0] <$str(L$测试2)>
sendmsg 7 输出结果：<$str(L$测试)>
;输出结果：[[aa,bb,cc],33,44,55,66,77,aa,bb]
七、获取列表子元素位置
借助 ESPGetListVarIndex 指令，可查询指定元素在列表中的下标位置，快速定位元素所在位置，适配数据检索场景。
;-----------------------------------------[获取子元素的位置]
ESPGetListVarIndex L$测试 aa N1
sendmsg 7 [L$测试]中"aa"位于第<$STR(N1)>个子元素
八、获取列表子元素总数量
通过 ESPGetListVarCount 指令，可自动统计当前列表中所有子元素的总个数，用于数据统计、循环遍历等场景。
;-----------------------------------------[获取子元素数量]
ESPGetListVarCount L$测试 N1
sendmsg 7 [L$测试]中有<$STR(N1)>个子元素
九、检查列表子元素是否存在
结合条件判断指令，可检测指定元素是否存在于列表中，根据检测结果执行不同逻辑，适配条件分支场景。
;-----------------------------------------[检查子元素是否存在]
#if
ESPCheckVarInList L$测试 bb
#act
sendmsg 7 [L$测试]中存在"bb"
#elseact
sendmsg 7 [L$测试]中不存在"bb"
十、变量下标动态调用示例
列表下标支持绑定变量，可通过动态变量控制读取、修改的列表位置，实现循环操作、动态赋值等灵活效果。
;-----------------------------------------[元素支持变量下标(示例)]
Mov N1 1
MOV L$测试[<$Str(N1)>] 23
sendmsg 7 输出结果：<$str(L$测试[<$Str(N1)>])>
十一、综合完整实操案例
整合赋值、修改、变量下标调用等全套操作，完整演示列表变量的实战用法，可直接运行测试。
;示例2
[@main]
<1.赋值/@mov测试> <2.inc测试/@inc测试> <3.dec测试/@dec测试>\
[@mov测试]
#act
MOV L$测试 [1,2,3,4,5,a]
sendmsg 7 首次赋值(L$测试)的值为：<$STR(L$测试)>
sendmsg 6 ----------------------------------
MOV L$测试[0] b
sendmsg 7 修改后(L$测试)的值为：<$STR(L$测试)>
sendmsg 7 当前(L$测试[0])的值为：<$STR(L$测试[0])>
sendmsg 6 ----------------------------------
MOV N$id 0
MOV L$测试[<$STR(N$ID)>] c
sendmsg 7 当前(L$测试[<$STR(N$ID)>])的值为：<$STR(L$测试[<$STR(N$ID)>])>
sendmsg 6 ----------------------------------
总结
以上涵盖了ESP脚本列表元素变量的所有常用基础操作，从基础赋值、元素增删改查，到嵌套列表、动态下标、元素校验统计，所有代码均经过规范整理，无报错隐患。新手可逐段复制测试，熟练掌握后可灵活应用于脚本编写、数据处理、逻辑判断等各类开发场景。