Skip to content

getgc

getgc returns a list of non-dead garbage-collectable values. These include functions, userdatas, and optionally tables.

function getgc(includeTables: boolean?): { { any } | (...any) -> (...any) | userdata }

Parameters

Parameter Description
includeTables? If true, also includes tables in the returned list. Defaults to false.

Example 1

Function-only GC scan
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
local dummy_table = {}
local function dummy_function() end
task.wait(0.05) -- Step a bit

for _, value in pairs(getgc()) do
    if value == dummy_function then
        print(`Found function: {dummy_function}`)
    elseif value == dummy_table then
        print(`Found table?: {dummy_table}`) -- This shouldn't print
    end
end

Example 2

Full GC scan including tables
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
local dummy_table = {}
local function dummy_function() end
task.wait(0.05) -- Step a bit

for _, value in pairs(getgc(true)) do
    if value == dummy_function then
        print(`Found function: {dummy_function}`) -- Should print
    elseif value == dummy_table then
        print(`Found table: {dummy_table}`) -- Should also print
    end
end