From WikiChip
Difference between revisions of "mirc/commands/hfree"
< mirc‎ | commands

(See also)
 
(One intermediate revision by the same user not shown)
Line 35: Line 35:
 
{{mIRC compatibility|5.8}}
 
{{mIRC compatibility|5.8}}
 
== See also ==
 
== See also ==
{{collist
 
|count = 3
 
|style = width: 60%; display: inherit;
 
|
 
 
* {{mIRC|/hmake}}
 
* {{mIRC|/hmake}}
 
* {{mIRC|/hload}}
 
* {{mIRC|/hload}}
Line 49: Line 45:
 
* {{mIRC|$hget}}
 
* {{mIRC|$hget}}
 
* {{mIRC|$hfind}}
 
* {{mIRC|$hfind}}
}}
 

Latest revision as of 18:29, 2 May 2023

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[edit]

/hfree [-sw] <table>

Switches[edit]

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

Parameters[edit]

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

Example[edit]

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[edit]

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[edit]