_Added in 1.9.0_

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

Decreases the value of the item by 'num'.

*Switches*

table(ktable).
|*Switch*|*Description*|
| -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. |
| -B | Performs a [[$calcint]] calculation instead of regular [[$calc]] when arithmetic operators are used. *(AdiIRC only)* |

*Parameters*

table(ktable).
|*Parameter*|*Description*|
| <name> | The hashtable where the item resides. |
| <item> | The hashtable item to decrease. |
| [num <notextile>|</notextile> &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>