Difference between revisions of "Table.find"
From GiderosMobile
(Created page with "__NOTOC__ '''Available since:''' Gideros 2022.3<br/> '''Class:''' table<br/> === Description === Within the given array-like table ''t'', find the first occurrence of ''v...") |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
| Line 5: | Line 5: | ||
=== Description === | === Description === | ||
Within the given array-like table ''t'', find the first occurrence of ''value'', starting from ''index'' or the beginning if not provided. If the value is not found, nil is returned. | Within the given array-like table ''t'', find the first occurrence of ''value'', starting from ''index'' or the beginning if not provided. If the value is not found, nil is returned. | ||
| − | < | + | <syntaxhighlight lang="lua"> |
(any) = table.find(t,value,index) | (any) = table.find(t,value,index) | ||
</source> | </source> | ||
| Line 20: | Line 20: | ||
=== Example === | === Example === | ||
| − | < | + | <syntaxhighlight lang="lua"> |
local t = {"a", "b", "c", "d", "e"} | local t = {"a", "b", "c", "d", "e"} | ||
print(table.find(t, "d")) --> 4 | print(table.find(t, "d")) --> 4 | ||
Revision as of 14:31, 13 July 2023
Available since: Gideros 2022.3
Class: table
Description
Within the given array-like table t, find the first occurrence of value, starting from index or the beginning if not provided. If the value is not found, nil is returned. <syntaxhighlight lang="lua"> (any) = table.find(t,value,index) </source>
A linear search algorithm is performed
Parameters
t: (table) source table
value: (any) value to find
index: (number) index to start the search at optional
Return values
Returns (any) the index of first occurence of value or nil if not found
Example
<syntaxhighlight lang="lua"> local t = {"a", "b", "c", "d", "e"} print(table.find(t, "d")) --> 4 print(table.find(t, "z")) --> nil, because z is not in the table print(table.find(t, "b", 3)) --> nil, because b appears before index 3 </source>
