$hmatch » History » Revision 5
Revision 4 (Per Amundsen, 01/16/2019 09:58 PM) → Revision 5/7 (Per Amundsen, 01/16/2019 10:04 PM)
_Added in 2.0_ *$hmatch(name|N,text,[N])* Searches table for the Nth item name which matches text using a [[Scripting_Wildcards|wildcard]] pattern and returns the item name. Uses [[Scripting_Wildcards|wildcard]] search by default. _See also [[/hsave]], [[/hload]], [[/hmake]], [[/hfree]], [[/hdel]], [[$hget]]._ _See also [[$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: $hmatch(Example, *, 0) ; Searches the hash table 'Example' and prints the first matched item. //echo -ag result: $hmatch(Example, *, 1) ; Searches the hash table 'Example' and prints the first matched data. //echo -ag result: $hmatch(Example, *, 1).data </pre>