WoW API: issecurevariable

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < issecurevariable

Determinates if given variable or table is secure or "tainted". Any usage of a "tainted" (= non-secure) variable, be it a function or simply data, will break secure state and prevent further access to Protected functions.

issecurevariable()

Parameters

Arguments

[table], variable

Return

nil (tainted) or 1 (secure)

Example 1

local secure = issecurevariable( "JumpOrAscendStart" );
if not ( secure == nil ) then 
 DEFAULT_CHAT_FRAME:AddMessage("OK! Given variable is secure!");
else
 DEFAULT_CHAT_FRAME:AddMessage("Given variable is not secure, doing stuff with it will break secure status. :s");
end

Result

• JumpOrAscendStart is a protected Blizzard-defined function, thus secure. Calling it will not break secure status.
• Message "OK! Given variable is secure!" will get displayed in your chat frame.

Example 2

some_variable_not_defined_by_blizzard = "bla39_j!";
local secure = issecurevariable( "some_variable_not_defined_by_blizzard" );
if not ( secure == nil ) then 
 DEFAULT_CHAT_FRAME:AddMessage("OK! Given variable is secure!");
else
 DEFAULT_CHAT_FRAME:AddMessage("Given variable is not secure, doing stuff with it will break secure status. :s");
end

Result

• Message "Given variable is not secure, doing stuff with it will break secure status. :s" will get displayed in your chat frame.

Notes

• Seems to always return 1 for nil variables.