builtin/misc.lua

   1 -- Minetest: builtin/misc.lua
   2
   3 --
   4 -- Misc. API functions
   5 --
   6
   7 minetest.timers_to_add = {}
   8 minetest.timers = {}
   9 minetest.register_globalstep(function(dtime)
  10         for _, timer in ipairs(minetest.timers_to_add) do
  11                 table.insert(minetest.timers, timer)
  12         end
  13         minetest.timers_to_add = {}
  14         for index, timer in ipairs(minetest.timers) do
  15                 timer.time = timer.time - dtime
  16                 if timer.time <= 0 then
  17                         timer.func(unpack(timer.args or {}))
  18                         table.remove(minetest.timers,index)
  19                 end
  20         end
  21 end)
  22
  23 function minetest.after(time, func, ...)
  24         table.insert(minetest.timers_to_add, {time=time, func=func, args={...}})
  25 end
  26
  27 function minetest.check_player_privs(name, privs)
  28         local player_privs = minetest.get_player_privs(name)
  29         local missing_privileges = {}
  30         for priv, val in pairs(privs) do
  31                 if val then
  32                         if not player_privs[priv] then
  33                                 table.insert(missing_privileges, priv)
  34                         end
  35                 end
  36         end
  37         if #missing_privileges > 0 then
  38                 return false, missing_privileges
  39         end
  40         return true, ""
  41 end
  42
  43 function minetest.get_connected_players()
  44         -- This could be optimized a bit, but leave that for later
  45         local list = {}
  46         for _, obj in pairs(minetest.get_objects_inside_radius({x=0,y=0,z=0}, 1000000)) do
  47                 if obj:is_player() then
  48                         table.insert(list, obj)
  49                 end
  50         end
  51         return list
  52 end
  53
  54 function minetest.hash_node_position(pos)
  55         return (pos.z+32768)*65536*65536 + (pos.y+32768)*65536 + pos.x+32768
  56 end
  57
  58 function minetest.get_item_group(name, group)
  59         if not minetest.registered_items[name] or not
  60                         minetest.registered_items[name].groups[group] then
  61                 return 0
  62         end
  63         return minetest.registered_items[name].groups[group]
  64 end
  65
  66 function minetest.get_node_group(name, group)
  67         return minetest.get_item_group(name, group)
  68 end
  69
  70 function minetest.string_to_pos(value)
  71         local p = {}
  72         p.x, p.y, p.z = string.match(value, "^([%d.-]+)[, ] *([%d.-]+)[, ] *([%d.-]+)$")
  73         if p.x and p.y and p.z then
  74                 p.x = tonumber(p.x)
  75                 p.y = tonumber(p.y)
  76                 p.z = tonumber(p.z)
  77                 return p
  78         end
  79         local p = {}
  80         p.x, p.y, p.z = string.match(value, "^%( *([%d.-]+)[, ] *([%d.-]+)[, ] *([%d.-]+) *%)$")
  81         if p.x and p.y and p.z then
  82                 p.x = tonumber(p.x)
  83                 p.y = tonumber(p.y)
  84                 p.z = tonumber(p.z)
  85                 return p
  86         end
  87         return nil
  88 end
  89
  90 assert(minetest.string_to_pos("10.0, 5, -2").x == 10)
  91 assert(minetest.string_to_pos("( 10.0, 5, -2)").z == -2)
  92 assert(minetest.string_to_pos("asd, 5, -2)") == nil)
  93
  94 function minetest.setting_get_pos(name)
  95         local value = minetest.setting_get(name)
  96         if not value then
  97                 return nil
  98         end
  99         return minetest.string_to_pos(value)
 100 end
 101
 102 function minetest.formspec_escape(str)
 103         str = string.gsub(str, "\\", "\\\\")
 104         str = string.gsub(str, "%[", "\\[")
 105         str = string.gsub(str, "%]", "\\]")
 106         return str
 107 end
 108