API getn

size = table.getn(table)
 size = getn(table)
This is used to determine the size of a table. The size of a table is discussed at the top of this page.
 > = table.getn({1,2,3}) -- Lua will count the elements if no size is specified
 3
 > = table.getn({1,2,3; n=10}) -- note, n overrides counting the elements
 10
 > t = {1,2,3}
 > table.setn(t, 10) -- set our own size with setn()
 > = table.getn(t)
 10
 > = table.getn({1,2,3,nil,5,6}) -- sequence ends at element 3 due to nil value at 4
 3
Note that Lua 5.1 has switched to the # operator. #t is the replacement for table.getn(t)
 > print( #{1,2,3} )
 3
However, it does not always behave as one might expect. Consider the following sequence:
 > t = { 1, 2, 3 }
 > dump (#t)
 3
 > t[1] = nil
 > dump (#t)
 3
 > dump (t)
 {
 [2] = 2
 [3] = 3
 } -- table: 0x807ff70
 > dump (#{ [2] = 2, [3] = 3 })
 0
As you can see, the # operator is unpredictable in that it can return different values for tables with identical contents. The Lua 5.1 reference manual has this to say about it :
 The length of a table t is defined to be any integer index such that t[n] is not nil and t[n+1] is nil.
In other words, be careful with this operator if you are using tables with holes in them. If your table has all its values between [1] and [n] for some n, with no nils in that range, the # operator will return n. Otherwise its result may be unclear.
Note:
The reason the returned values are different is because the tables are different. For indexed tables, or tables that start with index values like 1,2,3 for keys, use tinsert and tremove to change the contents. What # returns is actually correct, setting the index value to nil does not change the size of the table for index keys, tremove would.
==See Also==
* tcount