$hregex » History » Revision 2
Revision 1 (Per Amundsen, 01/16/2019 10:04 PM) → Revision 2/3 (Per Amundsen, 01/16/2019 10:05 PM)
_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]]._ [[$hfind]]._ *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>