AdiIRC

_Added in 1.9.0_

*/hdec [-bcmsuNz] <name> <item> [num | &binvar]*

Decreases the value of the item by 'num'.

*Switches*

-b - Indicates &binvar is set.

-c - Chop the &binvar to first null byte.

-m - Creates the table if it does not exist.

-s - Displays the result.

-uN - Unset the the item after N seconds.

-z - Decreases the item once per second until it reaches zero and then unsets it.

*Parameters*

<name> - The hashtable where the item resides.

<item> - The hashtable item to decrease.

[num | &binvar] - The number or &binvar to decrease by.

*Example*

<pre>

alias countdown {

  ;Adds the item down with a value of 10 to the table count.

  hadd -m count down 10

  echo -a $hget(count,down) $+ !

  :repeat

  ;Checks if the value of down returns true.

  if ($hget(count,down) > 1) {

    ;decreases down by 1

    hdec count down

    ;echos the current count

    echo -a $hget(count,down) $+ !

    ;repeats

    goto repeat

  }

  ;If the previous if statement returns false it carries on with this.

  else echo -a 0, Hurray!

  hfree -s count

}

</pre>