Editing mirc/commands/hdec

The '''/hdec command''' decreases the value of a key by [num]. If the value is not specified, the default value is 1.0.

== Synopsis ==
 /hdec [-mszu#] <table> <key> [num] 
 /hdec -b[cmszu#] <table> <key> <&bvar>

== Switches ==
* '''-m''' - Creates the hash table if it does not exist 
* '''-s''' - Displays the assignment information 
* '''-b''' - Treats the value as a binary variable 
* '''-c''' - Truncates the &bvar at the first null value 
* '''-z''' - Decreases the value by 1.0 every second; stops at zero 
* '''-u#''' - Removes the key/value after # seconds

== Parameters ==
* '''<table>''' - The handle name of the table to operate on 
* '''<key>''' - The key associated with the value 
* '''[num]''' - The value to decrease the value by
* '''<&bvar>''' - The binary variable value to decrease the value by

== Example ==
<syntaxhighlight lang="mIRC">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
}</syntaxhighlight>

== Compatibility ==
Added: mIRC v6.0

Added On: 03/02/2002




== See also ==
* [[List of commands - mIRC|List of commands]]
* [[List of identifiers - mIRC|List of identifiers]]
* {{mIRC|$hget}}
* {{mIRC|$hfind}}
* {{mIRC|/hadd}}
* {{mIRC|/hdel}}
* {{mIRC|/hfree}}
* {{mIRC|/hinc}}
* {{mIRC|/hload}}
* {{mIRC|/hmake}}
* {{mIRC|/hsave}}
{{mIRC command list}}

[[Category:MIRC commands]]