Difference between revisions of "Os.startTimer"

From ComputerCraft Wiki
Jump to: navigation, search
(Improved example.)
m (Link to the event this function triggers.)
Line 6: Line 6:
 
  |returns={{type|number}} timerID
 
  |returns={{type|number}} timerID
 
  |addon=ComputerCraft
 
  |addon=ComputerCraft
  |desc=Adds a timer which will fire a "timer" event once after <var>time</var> seconds have passed. It returns an int which acts as a unique ID for the timer. Fractions of a second are supported, but only down to a game tick, or 1/20 of a second (0.05s). Times are rounded up to the next tick, so os.sleep(1.01) and os.sleep(1.05) both wait for 1.05 seconds.
+
  |desc=Adds a timer which will fire a [[Timer_(event)|"timer" event]] once after <var>time</var> seconds have passed. It returns an int which acts as a unique ID for the timer. Fractions of a second are supported, but only down to a game tick, or 1/20 of a second (0.05s). Times are rounded up to the next tick, so os.sleep(1.01) and os.sleep(1.05) both wait for 1.05 seconds.
 
  |examples=
 
  |examples=
 
{{Example
 
{{Example

Revision as of 19:53, 19 December 2013


Grid Redstone.png  Function os.startTimer
Adds a timer which will fire a "timer" event once after time seconds have passed. It returns an int which acts as a unique ID for the timer. Fractions of a second are supported, but only down to a game tick, or 1/20 of a second (0.05s). Times are rounded up to the next tick, so os.sleep(1.01) and os.sleep(1.05) both wait for 1.05 seconds.
Syntax os.startTimer(number time)
Returns number timerID
Part of ComputerCraft
API OS

Examples

Grid paper.png  Example
Yields until 3 seconds have passed.
Code
local myTimer = os.startTimer(3)
while true do
local event,timerID = os.pullEvent("timer")
if timerID == myTimer then break end
end