Skip to content
Permalink
Browse files

Add table.shuffle (#8299)

  • Loading branch information
HybridDog committed Feb 1, 2020
1 parent 2b3490d commit ea5e231959365622607c8bfd953f6d96ec54a394
Showing with 21 additions and 0 deletions.
  1. +14 −0 builtin/common/misc_helpers.lua
  2. +7 −0 doc/lua_api.txt
@@ -576,6 +576,20 @@ function table.key_value_swap(t)
end


function table.shuffle(t, from, to, random)
from = from or 1
to = to or #t
random = random or math.random
local n = to - from + 1
while n > 1 do
local r = from + n-1
local l = from + random(0, n-1)
t[l], t[r] = t[r], t[l]
n = n-1
end
end


--------------------------------------------------------------------------------
-- mainmenu only functions
--------------------------------------------------------------------------------
@@ -2925,6 +2925,13 @@ Helper functions
find new indices.
* `table.key_value_swap(t)`: returns a table with keys and values swapped
* If multiple keys in `t` map to the same value, the result is undefined.
* `table.shuffle(table, [from], [to], [random_func])`:
* Shuffles elements `from` to `to` in `table` in place
* `from` defaults to `1`
* `to` defaults to `#table`
* `random_func` defaults to `math.random`. This function receives two
integers as arguments and should return a random integer inclusively
between them.
* `minetest.pointed_thing_to_face_pos(placer, pointed_thing)`: returns a
position.
* returns the exact position on the surface of a pointed node

0 comments on commit ea5e231

Please sign in to comment.
You can’t perform that action at this time.