Project

General

Profile

Added in 2.0

$hmatch(name|N,text,[N])

Searches table for the Nth item name which matches text using a wildcard pattern and returns the item name.

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

See also $hfind, $hregex.

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

; 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

Updated by Per Amundsen 3 days ago · 6 revisions

Also available in: PDF HTML TXT