supermobs.lua.utils

supermobs lua utils

time 时间工具

• settimeinterval(startts, timespan, count, callback)
  从startts秒后开始，每隔timespan秒回调一次callback，总共回调count次
  count <= 0 则无限循环，直到取消计时器
  return 计时器的编号
• canceltimeinterval(key)
  结束编号为key的timeinterval计时器
• settimeout(timespan, callback)
  timespan秒后回调callback
  return 计时器编号
• canceltimeout(key)
  结束编号为key的timeout计时器

event 事件工具

• dispatch(evt)
  触发一个事件，所有对应事件类型的侦听都被调用一次
  evt是一个luatable，必须包含'type'字段，标记事件类型
• listen(eventtype, handler, obj, once)
  侦听一个事件
  eventtype 事件类型，对应evt的type字段
  handler 事件的处理函数，回调时会传两个参数，obj、evt
  obj 事件处理函数的执行者，默认值nil
  once 是否在事件触发一次后侦听失效，默认false
  return 侦听器的id
• dispatchtype(eventtype)
  dispatch(evt)的简化版本，事件本身没有任何数据
• unlisten(id)
  删除指定id的侦听器

string

• split(s, p)
  把字符串s，用p来分隔成数组

table

orderdict 自动排序的字典

字典中的key是要排序的数据
value是排序的依据，类型为table数组，每项值为number类型

-- 创建一个排序器，排序依据的table有最多4个值
-- 依次按照升序、升序、降序、降序的方式排列
local compare = utils.table.compare.makearr(true, true, false, false)
-- 使用这个排序器创建一个orderdict
local dict = utils.table.createorderdict(compare)
-- 添加一些数据
dict["chiuan"] = {28, 15, 236, 0}
dict["levi"] = {27, 0, 0, 0}
dict["test"] = {28, 15, 0, 0}
-- 调用接口测试一下
-- 数据的数量
print(dict:getlen()) -- 3
-- 获取排序在第2位的数据
print(dict:getat(2)) -- test
-- 完整遍历一下
for k,v in dict:ipairs() do
    print(k, v) -- 1,levi   2,test  3,chiuan
end
-- 删除一项
dict["test"] = nil
-- 下面这样会导致error “orderdict do not support same order value”
dict["test_error"] = {27, 0, 0, 0}

sortdict 有序的字典

与原生table基本一样，唯一差别就是保证pairs的遍历顺序永远与添加进去的顺序一致

-- 创建一个有序字段
local  dict = utils.table.createsortdict()
-- 添加一些数据
dict["levi"] = 27
dict["chiuan"] = {}
dict["test"] = true
-- 使用接口测试一下
print(dict:getfirst())  -- 27
print(dict.count)   -- 3
-- 完整遍历
for k,v in dict:pairs() do
    print(k, v) -- levi,27  chiuan,table0x0000  test,true
end
-- 删除或更新会让这一项移动到最末位
dict["levi"] = 1
print(dict:getfirst())  -- table0x0000
dict["chiuan"] = {}
print(dict:getfirst())  -- true