util.event.off

Shared

Unregisters a previously registered handler from the specified event


Syntax

local status = util.event.off(
    name,
    exec
)

Parameters

TypeNameDescription
stringnameName of the event to unsubscribe from
functionexecHandler function reference to remove
Must be the same function value passed to util.event.on

Returns

TypeNameDescription
boolstatustrue if the handler was found and removed, false otherwise

Examples

Remove a previously registered handler
local function on_player_join(player)
    core.engine.print("info", "Player joined:", player)
end

util.event.on("on_player_join", on_player_join)
core.engine.print("info", "Handler removed:", util.event.off("on_player_join", on_player_join))
Conditionally unsubscribe based on state
local handler = nil
handler = function(value)
    if value == "done" then
        util.event.off("on_signal", handler)
    end
end

util.event.on("on_signal", handler)

On this page