Skip to main content

Lengths & Holes

InfArray tracks two distinct sizes.

MethodMeaning
Length()The highest assigned index, holes included. What #arr returns.
Count()The number of present (non-nil) elements.

Removals leave holes​

RemoveIndex clears a slot rather than shifting everything after it down. This keeps removal O(1), but it means the slot becomes a nil hole:

local arr = InfArray.new()
arr:PushBack("a") -- index 1
arr:PushBack("b") -- index 2
arr:PushBack("c") -- index 3

arr:RemoveIndex(2)

print(arr:Length()) --> 3  (highest index is unchanged)
print(arr:Count())  --> 2  (only "a" and "c" remain)
print(arr:Get(2))   --> nil

Why # is never trusted internally​

Once a Luau table contains holes, the result of #chunk is undefined. InfArray therefore tracks a per-chunk logical length explicitly (_lens) and always scans to that length. Your code should do the same when working with raw chunks. Never call # on a value returned by GetChunk. Instead, use the len handed to you by IterateChunks.

Iteration skips holes​

Both for..in iteration and Iterate skip holes automatically, so you only ever see present elements:

for index, value in arr do
    print(index, value) --> 1 a  |  3 c   (index 2 is skipped)
end