Project

General

Profile

$hfind » History » Version 19

Per Amundsen, 12/14/2019 09:33 AM

1 1 Per Amundsen
_Added in 1.9.0_
2
3
*$hfind(name|N,text,[N],[M],[@window|command])*
4
5
Searches table for the Nth item name which matches text and returns the item name.
6
7 10 Per Amundsen
_See also [[/hsave]], [[/hload]], [[/hmake]], [[/hfree]], [[/hdel]], [[$hget]]._
8
9 11 Per Amundsen
_See also [[$hmatch]], [[$hregex]]._
10 7 Per Amundsen
11 1 Per Amundsen
*Parameters*
12
13
name|N - Name of the hash table or the Nth hash table.
14
text - Text to search for.
15
[N] - If N = 0, number of matches, otherwise the Nth match. (optional)
16
[M] - (optional)
17
<pre>
18
 n - Normal text comparison. (default if M is not specified)
19 9 Per Amundsen
 w - Text is wildcard text.
20
 W - Hash table item/data is wildcard text.
21
 r - Text is a regular expression.
22 6 Per Amundsen
 R - Hash table item/data is a regular expression.
23 14 Per Amundsen
 N - Use case-sensitive match. *(AdiIRC only)*
24 19 Per Amundsen
 H - /halt won't halt the running script if used inside the [command]. it will only halt the $hfind's search. *(AdiIRC only)*
25 1 Per Amundsen
</pre>
26
27 4 Per Amundsen
[@window|command] - if @window is defined, fills the side-listbox with the results, otherwise the command is run on each result.
28 1 Per Amundsen
29
*Properties*
30
31
.data - Search for a matching data value instead of item name.
32
33
*Example*
34
35
<pre>
36
; 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.
37
//echo -ag result: $hfind(Example, *, 0, w, echo -ag $1-)
38
39
; Searches the hash table 'Example' and prints the number of matches.
40
//echo -ag result: $hfind(Example, *, 0, w)
41
42
; Searches the hash table 'Example' and prints the first matched item.
43
//echo -ag result: $hfind(Example, *, 1, w)
44
45
; Searches the hash table 'Example' and prints the first matched data.
46
//echo -ag result: $hfind(Example, *, 1, w).data
47
</pre>