API RegisterUserCommand

RegisterUserCommand

Definition: RegisterUserCommand(string commandname, func callback(dataarg, {arguments1, ..}), data) -> nil
Description:
hook up object to command
Arguments:
commandname string containing the command
callback function accepting two arguments to run when command is executed
dataarg see data
arguments1 arguments of the command (Note: if there are no arguments the table is nil not an empty table.)
data data to pass callback
Example:
<source lang="lua"> -- function to call when the command is entered local function printfunc(data, args)

 -- data contains the third parameter of RegisterUserCommand
 local str = tostring(data)
 -- if the command was entered without parameters args is nil otherwise a table containing the parameters
 if args then
   str = str..tostring(args[1])
 end
 print(str)

end RegisterUserCommand("printsomething", printfunc, "test")</source>
Registers the command "printsomething" that calls a function that prints the text "test" and the first argument appended