Editing mirc/identifiers/$hfind

{{mirc title|$hfind identifier}}'''$hfind''' Searches an hash table for the Nth item name which matches text. Returns item name.


== Synopsis ==
<pre>$hfind(name/N, text, N, M, @window | command)</pre>

== 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:
** n - normal text comparison
** w - wildcard expression
** W - hash table item/data is wildcard expression, see example below
** r - regular expression
** R - hash table item/data is regular expression, see example 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

== Example ==
<pre>//hadd -m test test test | echo -a $hfind(test,test,1) | hfree test</pre>

<pre>//hadd -m test test test | hadd -m test test test1 | echo -a $hfind(test,test*,0,w) | hfree test</pre>

== Compatibility ==
{{mIRC compatibility|5.81}}

= See also =
* {{mIRC|/hmake}}
* {{mIRC|/hadd}}
* {{mIRC|/hload}}
* {{mIRC|/hfree}}
* {{mIRC|/hdec}}
* {{mIRC|/hinc}}
* {{mIRC|$hget}}
{{mIRC identifier list}}

[[Category:mIRC identifiers]]