_Added in 3.3_

*$hregex(name|N,text,[N])*

Searches table for the Nth item name which matches text using a [[Scripting_Regex|regular expression]] and returns the item name.

_See also [[/hsave]], [[/hload]], [[/hmake]], [[/hfree]], [[/hdel]], [[$hget]]._

_See also [[$hfind]], [[$hmatch]]._

*Parameters*

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)

*Properties*

.data - Search for a matching data value instead of item name.

*Example*

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

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

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