# 变量组管理接口 Valuegroup

在使用变量组接口前需先创建变量组管理对象,方法如下:(此处已废弃)

local Valuegroup = class.Valuegroup.new()

具体函数名及描述如下:

序号 函数名 函数描述
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

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取组中所有值
  • 具体使用案例如下:
local code, datas = Valuegroup:getAllGroupItem(vartype, libname, playerid)
if code == ErrorCode.OK then
	print('执行成功', code, datas )
else
	print('执行失败')
end

# insertInGroupByName

  • 参数及类型:
    • vartype:number变量类型枚举(VARTYPE)VARTYPE
    • libname:string变量库名称
    • value:any插入的数据
    • playerid:number玩家ID
  • 返回值及类型:
  • 该方法的主要作用: 添加任意值到任意组
  • 具体使用案例如下:
local code = Valuegroup:insertInGroupByName(vartype, libname, value, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# removeValueIndexByName

  • 参数及类型:
    • vartype:number变量类型枚举(VARTYPE)VARTYPE
    • libname:string变量库名称
    • value:any插入的数据
    • playerid:number玩家ID
  • 返回值及类型:
  • 该方法的主要作用: 从任意组移除指定编号的值
  • 具体使用案例如下:
local code = Valuegroup:removeValueIndexByName(vartype, libname, indx, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# removeValueByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 从任意组移除任意值
  • 具体使用案例如下:
local code, val = Valuegroup:removeValueByName(vartype, libname, value, playerid)
if code == ErrorCode.OK then
	print('执行成功', code, val )
else
	print('执行失败')
end

# clearGroupByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 清空任意组
  • 具体使用案例如下:
local code, val = Valuegroup:clearGroupByName(vartype, libname, playerid)
if code == ErrorCode.OK then
	print('执行成功', code, val )
else
	print('执行失败')
end

# getGrouplengthByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取数组长度
  • 具体使用案例如下:
local code, len = Valuegroup:getGrouplengthByName(vartype, libname, playerid)
if code == ErrorCode.OK then
	print('执行成功', code, len )
else
	print('执行失败')
end

# getValueNoByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取组中索引的值
  • 具体使用案例如下:
local code, value = Valuegroup:getValueNoByName(vartype, libname, index, playerid)
if code == ErrorCode.OK then
	print('执行成功', code, value )
else
	print('执行失败')
end

# setValueNoByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 设置组中索引值
  • 具体使用案例如下:
local code = Valuegroup:setValueNoByName(vartype, libname, index, value, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# getRandomValueByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获得数组里面的随机值
  • 具体使用案例如下:
local code, val = Valuegroup:getRandomValueByName(vartype, libname, playerid)
if code == ErrorCode.OK then
	print('执行成功', code, val )
else
	print('执行失败')
end

# insertValueByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 在任意组插入任意值
  • 具体使用案例如下:
local code = Valuegroup:insertValueByName(vartype, libname, no, val, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# deleteNoByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 从任意组删除指定编号的值
  • 具体使用案例如下:
local code = Valuegroup:deleteNoByName(vartype, libname, no, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# deleteValueByName

  • 参数及类型:
    • vartype:number变量类型枚举(VARTYPE)VARTYPE
    • libvarname:string变量库名称
    • val:any删除的值
    • playerid:number玩家ID
  • 返回值及类型:
  • 该方法的主要作用: 删除组中指定值的值
  • 具体使用案例如下:
local code = Valuegroup:deleteValueByName(vartype, libname, val, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# clearNoValueByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 清空组中的空值
  • 具体使用案例如下:
local code = Valuegroup:clearNoValueByName(vartype, libname, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# addGroupByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 在任意组中添加一组值
  • 具体使用案例如下:
local code = Valuegroup:addGroupByName(vartype, libname, libname2, playerid, playerid2)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# removeGroupByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 在任意组中将一组值设为空值
  • 具体使用案例如下:
local code = Valuegroup:removeGroupByName(vartype, libname, libname2, playerid, playerid2)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# deleteGroupByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 在任意组中删除一组值
  • 具体使用案例如下:
local code = Valuegroup:deleteGroupByName(vartype, libname, libname2, playerid, playerid2)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# insertGroupByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 在任意组插入一组值
  • 具体使用案例如下:
local code = Valuegroup:insertGroupByName(vartype, libname, no, libname2, playerid, playerid2)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# replaceValueByName

  • 参数及类型:
    • vartype:number变量类型枚举(VARTYPE)VARTYPE
    • libname:string变量库名称
    • oldval:any组中的值
    • newval:any组中的新值
    • playerid:number玩家ID
  • 返回值及类型:
  • 该方法的主要作用: 替换任意组中的任意值
  • 具体使用案例如下:
local code = Valuegroup:replaceValueByName(vartype, libname, oldval, newval, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# sortGroupByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 对任意组的值排序
  • 具体使用案例如下:
local code = Valuegroup:sortGroupByName(vartype, libname, sortType, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# hasValueByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 任意组是否有任意值
  • 具体使用案例如下:
local code = Valuegroup:hasValueByName(vartype, libname, val, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# hasNoByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 任意组位置上是否有值
  • 具体使用案例如下:
local code = Valuegroup:hasNoByName(vartype, libname, no, playerid)
if code == ErrorCode.OK then
	print('执行成功', code )
else
	print('执行失败')
end

# getValueCountByName

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取任意组种任意值的数量
  • 具体使用案例如下:
local code, num = Valuegroup:getValueCountByName(vartype, libname, val, playerid)
if code == ErrorCode.OK then
	print('执行成功', code, num )
else
	print('执行失败')
end

# getGroupNoByValue

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用: 获取任意组种任意值的编号
  • 具体使用案例如下:
local code, no = Valuegroup:getGroupNoByValue(vartype, libname, val, playerid)
if code == ErrorCode.OK then
	print('执行成功', code, no )
else
	print('执行失败')
end

# getSpcialValueByName

  • 参数及类型:
    • libname:string变量库名称
    • val:number(1获取最大值,非1获取最小值)
    • playerid:number玩家ID
  • 返回值及类型:
  • 该方法的主要作用: 获取数值组最大最小值
  • 具体使用案例如下:
local code, no = Valuegroup:getSpcialValueByName(libname, type, playerid)
if code == ErrorCode.OK then
	print('执行成功', code, no )
else
	print('执行失败')
end
上次更新: 2023/5/10 15:09:30