（此类接口针对变量库中已创建的变量进行改动、调用）

具体函数名及描述如下:

序号	函数名	函数描述
1	getAllGroupItem(...)	获取组中所有值
2	insertInGroupByName(...)	添加任意值到任意组
3	removeValueIndexByName(...)	从任意组移除指定编号的值
4	removeValueByName(...)	从任意组移除任意值
5	clearGroupByName(...)	清空任意组
6	getGrouplengthByName(...)	获取数组长度
7	getValueNoByName(...)	获取组中索引值
8	setValueNoByName(...)	设置组中索引值
9	getRandomValueByName(...)	获得数组里面的随机值
10	insertValueByName(...)	在任意组插入任意值
11	deleteNoByName(...)	从任意组删除指定编号的值
12	deleteValueByName(...)	从任意组删除指定编号的值
13	clearNoValueByName(...)	从任意组删除指定编号的值
14	addGroupByName(...)	在任意组中添加一组值
15	removeGroupByName(...)	在任意组中将一组值设为空值
16	deleteGroupByName(...)	在任意组中删除一组值
17	insertGroupByName(...)	在任意组插入一组值
18	replaceValueByName(...)	替换任意组中的任意值
19	sortGroupByName(...)	对任意组的值排序
20	hasValueByName(...)	任意组是否有任意值
21	hasNoByName(...)	任意组位置上是否有值
22	getValueCountByName(...)	获取任意组种任意值的数量
23	getGroupNoByValue(...)	获取任意组种任意值的编号
24	getSpcialValueByName(...)	获取最大最小值

getAllGroupItem

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libname:string组名
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK
  • ret:table所有元素

• 该方法的主要作用：获取变量组中所有值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--获取类型为vartype的变量组中所有变量的值
	local result,ret=Valuegroup:getAllGroupItem(vartype, libname, playerid)
	print(ret)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

insertInGroupByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • value需:要添加的值
  • playerid:私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：添加任意值到任意组，加在组的最后一位

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local value=10--值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--添加value到vartype类型的变量组的最后一位
	Valuegroup:insertInGroupByName(vartype, libname, value, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

removeValueIndexByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • indx:number组中的编号索引
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：从任意组移除指定编号的值，变为nil，编号不会移除

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local index=1--序号
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--删除类型为vartype的变量组中序号为index的值，删除后值为nil
	Valuegroup:removeValueIndexByName(vartype, libname, index, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

removeValueByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • value需要删除的值
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：从任意组移除任意值为nil

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local value=10--值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--删除类型为vartype的变量组中值为value的值，删除后值为nil
	Valuegroup:removeValueByName(vartype, libname, value, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

clearGroupByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：清空任意组，编号和内容全部清空

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--清空类型为vartype名为libname的变量组
	Valuegroup:clearGroupByName(vartype, libname, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

getGrouplengthByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK
  • number:number数组长度

• 该方法的主要作用：获取数组长度

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--获取变量组长度
	local result,length=Valuegroup:getGrouplengthByName(vartype, libname, playerid)
	print(length)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

getValueNoByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • indx:number组中的编号索引
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK
  • libvarid:number编号的值

• 该方法的主要作用：获取组中指定编号的值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local index=1--序号
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--获取变量组指定序号的值
	local result,value=Valuegroup:getValueNoByName(vartype, libname, index, playerid)
	print(value)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

setValueNoByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • indx:number组中的编号索引
  • value设置的值
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：设置组中编号索引的值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local index=1--序号
	local value=10--要设置的值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--设置变量组指定序号的值为value
	Valuegroup:setValueNoByName(vartype, libname, index, value, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

getRandomValueByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名

• 返回值及类型：

  • ErrorCode.OK
  • value获取到的值

• 该方法的主要作用：随机获得数组里面的值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--随机获取变量组中的一个值
	local result,value=Valuegroup:getRandomValueByName(vartype, libname, playerid)
	print(value)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

insertValueByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • no插入的编号位置
  • value设置的值
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：在任意组任意编号位置插入任意值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local no=1--要插入的位置
	local val=10--要插入的值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--在变量组中no的位置插入值val
	Valuegroup:insertValueByName(vartype, libname, no, val, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

deleteNoByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • no清空的编号位置
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：从任意组清空指定编号的值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local no=1--要清空的编号位置
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--清空变量组中编号为no的值
	Valuegroup:deleteNoByName(vartype, libname, no, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

deleteValueByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • val清空的值
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：从任意组清空指定值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local val=10--要清空的值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--清空变量组中值为val的值
	Valuegroup:deleteValueByName(vartype, libname, val, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

addGroupByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • libvarid2:string组名
  • playerid1:私有组的玩家ID，全局组为0
  • playerid2:私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：在组1的末尾添加组2的值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local libname="数值组02"--组名
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	local playerid2=0--私有变量组所属玩家id，0代表全局变量组
	--在libname组的末尾添加libname2组的值
	Valuegroup:addGroupByName(vartype, libname, libname2, playerid, playerid2)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

removeGroupByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • libvarid2:string组名
  • playerid1:私有组的玩家ID，全局组为0
  • playerid2:私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：比较组1和组2，若组1中有与组2种相同的值则设为nil

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local libname2="数值组02"--组名
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	local playerid2=0--私有变量组所属玩家id，0代表全局变量组
	--将libname组中和libname2组中重复的值设为nil
	Valuegroup:removeGroupByName(vartype, libname, libname2, playerid, playerid2)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

deleteGroupByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • libvarid2:string组名
  • playerid1:私有组的玩家ID，全局组为0
  • playerid2:私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：比较组1和组2，若组1中有与组2种相同的值则清除

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local libname2="数值组02"--组名
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	local playerid2=0--私有变量组所属玩家id，0代表全局变量组
	--将libname组中和libname2组中重复的值清除
	Valuegroup:deleteGroupByName(vartype, libname, libname2, playerid, playerid2)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

insertGroupByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • no:number插入的位置
  • libvarid2:string组名
  • playerid1:私有组的玩家ID，全局组为0
  • playerid2:私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：在组1指定编号位置插入组2的值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local no=1--要插入的位置
	local libname2="数值组02"--组名
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	local playerid2=0--私有变量组所属玩家id，0代表全局变量组
	--把libname2组的值插入到libname组编号为no的位置
	Valuegroup:insertGroupByName(vartype, libname, no, libname2, playerid, playerid2)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

replaceValueByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • oldval旧值
  • newval新值
  • playerid私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：替换任意组中的任意值为新的值

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local oldval=10--要替换掉的值
	local newval=20--替换为的值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--把组中值为oldval的值替换为newval
	Valuegroup:replaceValueByName(vartype, libname, oldval, newval, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

sortGroupByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • sortType排序类型排序类型升序：0，降序：1
  • playerid1私有组的玩家ID，全局组为0

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：对任意组的值排序

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local sortType=1--排序方式：0升序 1降序
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--对组中的值排序
	Valuegroup:sortGroupByName(vartype, libname, sortType, playerid)
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

hasValueByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • val查询的值
  • playerid私有组的玩家ID

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：任意组是否有任意值，如果有result返回0

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local val=10--要检测的值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--检测组中是否包含val
	local result=Valuegroup:hasValueByName(vartype, libname, val, playerid)
	if result==0 then
		Chat:sendSystemMsg("包含")
	else
		Chat:sendSystemMsg("不包含")
	end
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

hasNoByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • no:number索引值
  • playerid私有组的玩家ID

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：任意组位置上是否有值，有则result返回0

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local no=1--要检测的编号
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--检测组中no的位置是否有值
	local result=Valuegroup:hasNoByName(vartype, libname, no, playerid)
	if result==0 then
		Chat:sendSystemMsg("有值")
	else
		Chat:sendSystemMsg("没有值")
	end
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

getValueCountByName

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • val查询的值
  • playerid私有组的玩家ID

• 返回值及类型：

  • ErrorCode.OK
  • libvarid:number值数量

• 该方法的主要作用：获取任意组种任意值的数量

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local val=10--要计数的值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--获取组中值为val的数量
	local result,num=Valuegroup:getValueCountByName(vartype, libname, val, playerid)
	print(num)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

getGroupNoByValue

• 参数及类型：

  • vartype: VARTYPE枚举组类型
  • libvarid:string组名
  • val查询的值
  • playerid私有组的玩家ID

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：获取任意组种任意值的编号，如果多个相同值，只返回第一个

• 具体使用案例如下：

local function ClickBlock(event)
	local vartype=17--变量组类型，17是数值组
	local libname="数值组01"--组名
	local val=10--要获取编号的值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--获取组中值为val的编号
	local result,no=Valuegroup:getGroupNoByValue(vartype, libname, val, playerid)
	print(result,no)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块

getSpcialValueByName

• 参数及类型：

  • libvarid:string组名
  • type取最小值参数为0，最大值参数为1

• 返回值及类型：

  • ErrorCode.OK

• 该方法的主要作用：获取组内最大最小值

• 具体使用案例如下：

local function ClickBlock(event)
	local libname="数值组01"--组名
	local itype=1--获取类型：0最小值 1最大值
	local playerid=0--私有变量组所属玩家id，0代表全局变量组
	--获取组中最值
	local result,m=Valuegroup:getSpcialValueByName(libname, itype, playerid)
	print(result,m)--在日志输出
end
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], ClickBlock)--点击方块