Leunsel: Initial page creation.

2026-06-26T20:36:21Z

Initial page creation.

New page

[[Category:Lua]]
{{CodeBox|'''function''' unregisterAssembler(''id'') ''':''' void}}

Unregisters a previously registered assembler callback.

The <code>id</code> parameter must be the ID returned by [[Lua:registerAssembler|registerAssembler]].

===Function Parameters===
{|width="85%" cellpadding="10%" cellspacing="0" border="0"
!align="left"|Parameter
!align="left"|Type
!style="width: 80%;background-color:white;" align="left"|Description
|-
|id
|Integer
|The assembler registration ID returned by registerAssembler.
|}

===Returns===
This function does not return a value.

===Examples===

====Register and unregister an assembler callback====
<syntaxhighlight lang="lua" line highlight="1,9">
local assemblerID = registerAssembler(function(address, instruction)
if instruction:lower() == "customnop" then
return {0x90}
end

return nil
end)

unregisterAssembler(assemblerID)
</syntaxhighlight>

====Unregister only if an ID exists====
<syntaxhighlight lang="lua" line highlight="10">
local assemblerID = registerAssembler(function(address, instruction)
if instruction:lower() == "customnop2" then
return {0x66, 0x90}
end

return nil
end)

if assemblerID ~= nil then
unregisterAssembler(assemblerID)
assemblerID = nil
end
</syntaxhighlight>

====Replace an assembler callback====
<syntaxhighlight lang="lua" line highlight="2">
if CustomAssemblerID ~= nil then
unregisterAssembler(CustomAssemblerID)
end

CustomAssemblerID = registerAssembler(function(address, instruction)
if instruction:lower() == "ret0" then
return {0x31, 0xC0, 0xC3}
end

return nil
end)
</syntaxhighlight>

====Store multiple assembler IDs====
<syntaxhighlight lang="lua" line highlight="18">
local assemblerIDs = {}

assemblerIDs[#assemblerIDs + 1] = registerAssembler(function(address, instruction)
if instruction:lower() == "customnop" then
return {0x90}
end

return nil
end)

assemblerIDs[#assemblerIDs + 1] = registerAssembler(function(address, instruction)
print(string.format("Assembler callback at %X: %s", address, instruction))

return nil
end)

for i, id in ipairs(assemblerIDs) do
unregisterAssembler(id)
end

assemblerIDs = {}
</syntaxhighlight>

====Use an unregister helper====
<syntaxhighlight lang="lua" line highlight="8">
local function unregisterCustomAssembler()
if CustomAssemblerID ~= nil then
unregisterAssembler(CustomAssemblerID)
CustomAssemblerID = nil
end
end

unregisterCustomAssembler()
</syntaxhighlight>

====Disable a temporary assembler extension after use====
<syntaxhighlight lang="lua" line highlight="13">
local assemblerID = registerAssembler(function(address, instruction)
if instruction:lower() == "customnop" then
return {0x90}
end

return nil
end)

autoAssemble([[
customnop
]])

unregisterAssembler(assemblerID)
</syntaxhighlight>

{{LuaSeeAlso}}

{{Assembly}}

Lua:unregisterAssembler - Revision history

Leunsel: Initial page creation.