The timer event is fired when an alarm started with os.setAlarm completes.

Return Values

  1. string: The event name.
  2. number: The ID of the alarm that finished.


Starts a timer and then prints its ID:

local alarmID = os.setAlarm(os.time() + 0.05)
local event, id
    event, id = os.pullEvent("alarm")
until id == alarmID
print("Alarm with ID " .. id .. " was fired")

See also