AdiIRC

_Added in 1.9.0_

*/timers [off]*

*/timer[n|name] [off]*

*/timer[n|name] [-cdehimopr] [time] <repetitions> <interval> <code>*

Creates a timer that runs <code> at an interval.

If you are connected to server when the timer is started, it defaults to being a online timer, otherwise it will be a offline timer.

A offline timer will continue to run even if the server is disconnected, while a online timer will stop the timer when disconnected.

_$identifiers and %vars in the <code> are evaluated at the creation time of the timer, to evaluate during the timer tick, the $ and % must be combined like this $ $+ identifier, % $+ varname._

*Switches*

-c - TODO

-d - TODO

-e - Execute the code associated with a timer.

-h - Create a high-resolution timer.

-i - Dynamically associates itself with the active connection.

-m - Treat the interval parameter as milliseconds instead of seconds.

-o - Create a offline timer.

-p - Pause a timer.

-P - Pause a timer.

-r - Resume a timer.

*Parameters*

[off] - Turns of a timer.

[n|name] - The name or index of the timer.

[time] - Executes the timer at the specified time in HH:MM (24 hour) format.

<repetitions> - The amount of timer the timers should repeat itself. An repetition value of '0' will repeat for ever.

<interval> - The delay between two consecutive timer executions

<code> - Code to be executed. 

*Example*

<pre>

alias example {

  ; Create a variable and set value to 5.

  var %reps = 5

  ; Call the timer %reps times after 1 second delay.

  .timer %reps 1 countdown 

  ; Print the first count.

  count-down

}

alias -l countdown {

  echo -ag Count: $timer($ltimer).reps

}

; Simple timer that sends a reply after 10 seconds.

on *:TEXT:hi:#freenode:{ timer 1 10 msg $chan Hello, $nick $+ ! }

</pre>