From WikiChip
/hfree Command - mIRC
< mirc‎ | commands
Revision as of 13:13, 20 October 2018 by Sophist (talk | contribs)

The /hfree command destroys previously created hash table(s) along with all item/data pairs within them. A hash table can be created via the /hmake command.

Synopsis

/hfree [-sw] <table>

Switches

  • -s - Displays debug information
  • -w - Treats <table> as a wildcard and deletes all matching tables.

Parameters

  • <table> - the table you wish to delete.

Example

alias del_hash {
  ;makes the hash table 'hash'
  hmake hash
  echo -a $hget(hash) : $hget(hash).size
  ;makes the hash table 'h' with 10 buckets
  hmake h 10
  ;makes the hash table 'has' with 20 buckets
  hmake has 20
  ;deletes hash table 'hash'
  hfree -s hash
  echo -a $hget(h) : $hget(h).size - $hget(has) : $hget(has).size
  ;deletes any hash tables matching h*
  hfree -sw h*
}
//hfree -s test | hfree -s test | echo -a test message
* When not using the -w switch, trying to free a non-existent table is an error which halts execution of a script, so the echo does not display
 
//hfree -sw test | hfree -sw test | echo -a test message
* Using the -w switch allows deleting zero tables matching the wildcard, enabling the echo to display.

Compatibility

Added: mIRC v5.8
Added on: 05 Sep 2000
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See also