Garry's Mod Wiki

Revision Difference

table.Count#511814

<function name="Count" parent="table" type="libraryfunc"> <description> Counts the amount of keys in a table. This should only be used when a table is not numerically and sequentially indexed. For those tables, consider the length (**#**) operator. If you only want to test if the table is empty or not, use <page>table.IsEmpty</page> instead as it is a lot faster. </description> <realm>Shared and Menu</realm> <file line="159">lua/includes/extensions/table.lua</file> <args> <arg name="tbl" type="table">The table to count the keys of.</arg> </args> <rets> <ret name="" type="number">The number of keyvalue pairs. This includes non-numeric and non-sequential keys, unlike the length (**#**) operator.</ret> </rets> </function> <example> <description>There are 4 keys in this table. So it will output "4"</description> <code> local Table = { A = "1", B = "2", C = "3", D = "4" } print( table.Count( Table ) ) </code> <outputfixedwidth>Fixed width</outputfixedwidth> <output>4</output> </example> <example> <description> Difference between the length (**#**) operator and this function. The length (**#**) operator is generally considered faster, but has limitations. </description> <code> local Table = { A = "1", B = "2", C = "3", D = "4" } print( table.Count( Table ), #Table ) -- #Table will return 0 because the table contains no numeric keys local Table2 = { "test1", "test2", "test3" } -- 1 = "test1", 2 = "test2" print( table.Count( Table2 ), #Table2 ) -- Both will be 3 Table2[ 5 ] = "test5" -- Insert a new value at index 5, so index 4 does not exist -- table.Count here will return correct value, #Table2 will return 3 because -- the new value is non sequential ( there is nothing at index 4 ) print( table.Count( Table2 ), #Table2 ) </code> <outputfixedwidth>Fixed width</outputfixedwidth> <output> 4 0 3 3 4 3 </output> </example>