WoW:API ipairs: Difference between revisions

WoW:API ipairs (source)

717 bytes added , 15 August 2023

m

Move page script moved page API ipairs to WoW:API ipairs without leaving a redirect

Anonymous user

@@ Line 1: / Line 1: @@
-Comes from the native LUA API:
+{{luaapi}}
+Returns an iterator triple that allows the Lua for loop to iterate over the array portion of a table.
-Used in loop constructs to iterate through the values of a table where the index are only numbers, or where there is no index (an array).
+ iteratorFunc, table, startState = ipairs(table)
-Example:
+== Example ==
   local fruits={"apple","orange","banana","kiwi"}
@@ Line 19: / Line 18: @@
 would be output to the chat window.
+Note that ipairs() starts at index 1 and stops counting as soon as it reaches a nil value. Example:
+ > t = { [0]      = "zero",   --will not be counted
+         [1]      = "one",    --will be counted; 1
+         [2]      = "two",    --will be counted; 2
+         [3]      = "three",  --will be counted; 3
+         ["four"] = "four",   --will not be counted; returns 3
+         [5]      = "five" }  --will never be reached
+ > for i,v in ipairs(t) do print(i..":"..v) end
+:one
+:two
+:three
+Note that t[0] is never reached because it starts counting at [1], t["four"] is never reached because it is not an array index, and t[5] is never reached because the iterator ceases when it checks t[4] and finds a nil value.