world.GetTimer

MUSHclient script function (Method)

Gets details about a timer

Prototype

long GetTimer(BSTR TimerName, VARIANT* Hour, VARIANT* Minute, VARIANT* Second, VARIANT* ResponseText, VARIANT* Flags, VARIANT* ScriptName);

Data type meanings

Description

Gets details about the specified timer name.

See AddTimer for a description of the meanings of the fields.

This function does not appear to work when using Jscript or PerlScript, so if you are using those languages you should see GetTimerInfo instead. See below for how it works with Lua.

VBscript example

dim timername
dim timerhour
dim timerminute
dim timersecond
dim timerresponse
dim timerflags
dim timerscriptname
dim iStatus

iStatus = world.gettimer (timername, timerhour, timerminute, _
            timersecond, timerresponse, _
            timerflags, timerscriptname)

Jscript example

// Use GetTimerInfo when using Jscript

PerlScript example

# Use GetTimerInfo when using PerlScript

Python example

# Use GetTimerInfo when using Python

Lua example

local status

local hour
local minute
local second
local response
local flags
local scriptname

status, hour, minute, second, response, flags, scriptname = 
  GetTimer ("my_timer")

print (hour, minute, second, response, flags, scriptname)

Lua notes

Lua does not let you call by reference, however it can return multiple results.

Thus GetTimer is implemented to return the various fields as a multiple-return result,
as shown in the example above.

Return value

eInvalidObjectLabel: The timer name is not valid
eTimerNotFound: The named timer does not exist
eOK: completed OK

Return code meanings

Related topic

Timers

See also