Semiconductor & Computer Engineering
From WikiChip
Difference between revisions of "mirc/identifiers/$hfind"
| Line 1: | Line 1: | ||
{{mirc title|$hfind identifier}}'''$hfind''' Searches an hash table for the Nth item name which matches text. Returns item name. | {{mirc title|$hfind identifier}}'''$hfind''' Searches an hash table for the Nth item name which matches text. Returns item name. | ||
| + | |||
| + | '''Note''': there are no convenient way to stop the $hfind search, using {{mIRC|/halt}} from the command parameter (or inside the alias) will halt the full script. | ||
Revision as of 06:43, 15 December 2019
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
$hfind Searches an hash table for the Nth item name which matches text. Returns item name.
Note: there are no convenient way to stop the $hfind search, using /halt from the command parameter (or inside the alias) will halt the full script.
Synopsis
$hfind(name/N, text, N, M, @window | command)
Parameters
- name/N - the Nth hash table or the name of it
- text - the expression to use to find a match
- N - The Nth match, use 0 to get the total number of match or to trigger the @window | command parameter for all matches
- M - optional, a letter indicating how to match, default to value normal text comparison (n) below:
- command | @win -- if you pass a @win name, the item name that matched is put in the window, otherwise mirc evaluate the command for each match, $1 can be used to access the item name
Properties
- .data - instead of looking for matches against item, matches against data, but the item name is still returned.
Example
//hadd -m test test test | echo -a $hfind(test,test,1) | hfree test
//hadd -m test test test | hadd -m test test test1 | echo -a $hfind(test,test*,0,w) | hfree test
//hadd -m test t*t | echo -a $hfind(test,this is a test,0,W) | hfree test
//hadd -m test t.+t | hadd -m test t(?=his) | echo -a $hfind(test,this is a test,0,R,echo -s $1) | hfree test
Compatibility
Added: mIRC v5.81
Added on: 09 Nov 2000
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.
See also
mIRC identifier list