Added in 1.9.0


Searches table for the Nth item name which matches text and returns the item name.

See also /hsave, /hload, /hmake, /hfree, /hdel, $hget.

See also $hmatch, $hregex.


Parameter Description
name|N Name of the hash table or the Nth hash table.
text Text to search for.
[N] If N = 0, number of matches, otherwise the Nth match. (optional)
[options] Options.
[@window|command] if @window is defined, fills the side-listbox with the results, otherwise the command is run on each result.


Option Description
n Normal text comparison. (default if M is not specified)
w Text is wildcard text.
W Hash table item/data is wildcard text.
r Text is a regular expression.
R Hash table item/data is a regular expression.
N Use case-sensitive match. (AdiIRC only)
H /halt will halt the running script if used inside the [command]. (AdiIRC only)


Property Description
.data Search for a matching data value instead of item name.


; Searches hash table 'Example' for all items using and runs the command 'echo -ag $1-' on each result, $1- holds the item name or data.
//echo -ag result: $hfind(Example, *, 0, w, echo -ag $1-)

; Searches the hash table 'Example' and prints the number of matches.
//echo -ag result: $hfind(Example, *, 0, w)

; Searches the hash table 'Example' and prints the first matched item.
//echo -ag result: $hfind(Example, *, 1, w)

; Searches the hash table 'Example' and prints the first matched data.
//echo -ag result: $hfind(Example, *, 1, w).data

Updated by Per Amundsen 4 months ago · 21 revisions

Also available in: PDF HTML TXT