Table.element - Revision history

Enargy: Created page with "{{Useful Function}} NOTOC This function allows you to search within a table of any size or dimensions, userdata values. ==Syntax==
2020-02-22T23:30:20Z

Created page with "{{Useful Function}} <lowercasetitle></lowercasetitle> NOTOC This function allows you to search within a table of any size or dimensions, userdata values. ==Syntax== <synt..."

New page
{{Useful Function}}
<lowercasetitle></lowercasetitle>
NOTOC
This function allows you to search within a table of any size or dimensions, userdata values.

==Syntax==
<syntaxhighlight lang="lua">table table.element( table tbl[, string theType=nil ] )</syntaxhighlight>

===Required Arguments===
* '''tbl''': The table for search within.

===Optional Arguments===
* '''theType''': The type of element you want a list of. For example:
'''"player"'''
'''"vehicle"'''
** '''"ped"'''

===Returns===
Returns a new table with only userdata content.

==Code==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function table.element(t, elemType, _aux)
local elem = _aux or {}
for k, v in pairs(t) do
if (type(v) == "table") then
table.element(v, elemType, elem)
else
if (type(v) == "userdata") then
if elemType then
if (getElementType(v) == elemType) then
table.insert(elem, v)
end
else
table.insert(elem, v)
end
end
end
end
return elem
end
</syntaxhighlight>
</section>

==Example==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
local vehicle = createVehicle(411, 0, 0, 0)
local ped = createPed(200, 0, 0, 0)

local myTable = {
["randomsh*t"] = {
localPlayer,
{localPlayer},
{{localPlayer, ped, "I Luv U", 20, false, true}},
{["player"] = localPlayer},
["vehicle"] = vehicle,
45778972,
"Hello World",
true,
ped
},
}

local info = table.element(myTable)

for index, value in ipairs(info) do
outputChatBox("The type of element is: " .. getElementType(value))
end

-- output:
-- The type of element is: player
-- The type of element is: player
-- The type of element is: player
-- The type of element is: ped
-- The type of element is: player
-- The type of element is: ped
-- The type of element is: vehicle
</syntaxhighlight>
</section>

Author: Enargy

==See Also==
{{Useful_Functions}}