KillTimer: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(changed the pos example)
(OOP syntax added)
 
(3 intermediate revisions by 2 users not shown)
Line 5: Line 5:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool killTimer ( int timerID )
bool killTimer ( timer theTimer )
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[timer]]:destroy||}}
===Required Arguments===  
===Required Arguments===  
*'''timerID:''' The timer you wish to halt.
*'''theTimer:''' The [[timer]] you wish to halt.


===Returns===
===Returns===
Returns ''true'' if a timer was successfully killed, ''false'' if no timer with the ID provided existed.
Returns ''true'' if the timer was successfully killed, ''false'' if no such timer existed.


==Example==  
==Example==  
Line 24: Line 24:
       killTimer ( timerValue )
       killTimer ( timerValue )
end
end
</syntaxhighlight>
This example checks if the time then kill the timer.
<syntaxhighlight lang="lua">
-- set timer output text in chat box
local Timer = setTimer ( function ( ) outputChatBox ( 'Hello World !' ) end, 60000, 0 )
-- Check the timer then kill the timer
if isTimer ( Timer ) then killTimer ( Timer ) end
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Utility functions}}
{{Utility functions}}

Latest revision as of 07:01, 12 July 2014

This function allows you to kill/halt existing timers.

Syntax

bool killTimer ( timer theTimer )

OOP Syntax Help! I don't understand this!

Method: timer:destroy(...)


Required Arguments

  • theTimer: The timer you wish to halt.

Returns

Returns true if the timer was successfully killed, false if no such timer existed.

Example

This example kills all timers with a remaining time of less than 1 minute.

-- Find and kill all the timers with less than 1 minute to go
timers = getTimers ( 60000 )
-- Loop through the timer list
for timerKey, timerValue in ipairs(timers) do
	-- kill the timer
      killTimer ( timerValue )
end

This example checks if the time then kill the timer.

-- set timer output text in chat box
local Timer = setTimer ( function ( ) outputChatBox ( 'Hello World !' ) end, 60000, 0 )
-- Check the timer then kill the timer
if isTimer ( Timer ) then killTimer ( Timer ) end

See Also