From WikiChip
Difference between revisions of "mirc/commands/hfree"
m (Bot: Automated text replacement (-Added On:.+\n?\n?\n?\n?\n? +)) |
(→See also) |
||
(9 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | The '''/hfree | + | {{mirc title|/hfree Command}} |
− | + | 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 {{mIRC|/hmake}} command. | |
== Synopsis == | == Synopsis == | ||
/hfree [-sw] <nowiki><table></nowiki> | /hfree [-sw] <nowiki><table></nowiki> | ||
− | |||
== Switches == | == Switches == | ||
* '''-s''' - Displays debug information | * '''-s''' - Displays debug information | ||
− | * '''-w''' - Treats <nowiki><table></nowiki> as a wildcard and deletes all matching tables. | + | * '''-w''' - Treats <nowiki><table></nowiki> as a {{mirc|wildcard}} and deletes all matching tables. |
− | |||
== Parameters == | == Parameters == | ||
− | |||
* '''<nowiki><table></nowiki>''' - the table you wish to delete. | * '''<nowiki><table></nowiki>''' - the table you wish to delete. | ||
− | |||
== Example == | == Example == | ||
<syntaxhighlight lang="mIRC">alias del_hash { | <syntaxhighlight lang="mIRC">alias del_hash { | ||
Line 28: | Line 24: | ||
}</syntaxhighlight> | }</syntaxhighlight> | ||
− | = | + | <source lang="mIRC"> |
− | + | //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. | ||
+ | </source> | ||
+ | == Compatibility == | ||
+ | {{mIRC compatibility|5.8}} | ||
== See also == | == See also == | ||
− | * | + | * {{mIRC|/hmake}} |
− | * | + | * {{mIRC|/hload}} |
− | * {{mIRC| | + | * {{mIRC|/hsave}} |
− | * {{mIRC| | + | * {{mIRC|Hash Tables}} |
* {{mIRC|/hadd}} | * {{mIRC|/hadd}} | ||
− | |||
* {{mIRC|/hdel}} | * {{mIRC|/hdel}} | ||
* {{mIRC|/hinc}} | * {{mIRC|/hinc}} | ||
− | * {{mIRC|/ | + | * {{mIRC|/hdec}} |
− | * {{mIRC| | + | * {{mIRC|$hget}} |
− | * {{mIRC| | + | * {{mIRC|$hfind}} |
− | |||
− | |||
− |
Latest revision as of 18:29, 2 May 2023
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
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.