Vliedel at 13:05, 3 February 2011

2011-02-03T13:05:51Z

← Older revision		Revision as of 13:05, 3 February 2011
Line 47:		Line 47:

	[[Category:Hash Table]]		[[Category:Hash Table]]
			[[Category:Identifiers]]

Doomie: changed example a little bit

2005-11-20T20:29:30Z

changed example a little bit

← Older revision		Revision as of 20:29, 20 November 2005
Line 29:		Line 29:

	The first example will just search for user1@random.host and returns the item (''user1''):		The first example will just search for user1@random.host and returns the item (''user1''):
	[[echo]] -a $hfind(testhash,~~user1~~@~~random~~.~~host~~,1).data		[[echo]] -a $hfind(testhash,Dana@staff.quakenet.org,1).data

	The next example will loop through all data's containing user and return the item and data.		The next example will loop through all data's containing user and return the item and data.

Doomie at 20:27, 20 November 2005

2005-11-20T20:27:36Z

New page

Searches table for the Nth item name which matches text. Returns item name.
$hfind(name/N, text, N, M)[.data]

If you specify the .data property, it searches for a matching data value.

M is optional, and can be:
<table width="50%">
<tr><td width="10%"><b>M</b></td><td><b>Explanation</b></td></tr>
<tr><td>n</td><td>normal text comparison (default if M isn't specified)</td></tr>
<tr><td>w</td><td>text is wildcard text</td></tr>
<tr><td>W</td><td>hash table item/data is wildcard text</td></tr>
<tr><td>r</td><td>text is regular expression</td></tr>
<tr><td>R</td><td>hash table item/data is regular expression</td></tr>
</table>

'''Note''' that if you specify N = 0, it will return the total amount of matching items (see the second example below).

== Example ==
At first, we need a hashtable for all examples, so lets make one:
; have a nice alias called ''makehash'' for it
[[alias]] makehash {
; here we actually ''make'' the hashtable
[[hmake]] testhash 100
; now lets put data in it
[[hadd]] testhash Dana Dana@staff.quakenet.org
hadd testhash user1 user1@random.host
hadd testhash user2 user2@another.host
}

The first example will just search for user1@random.host and returns the item (''user1''):
[[echo]] -a $hfind(testhash,user1@random.host,1).data

The next example will loop through all data's containing *user* and return the item and data.

''user1 => user1@random.host''

''user2 => user2@another.host''
[[var]] %i = 1
; let's start the looping. $find(testhash,*user*,0,w).data returns the total amount of found items.
[[while]] (%i <= $hfind(testhash,*user*,0,w).data) {
; this echos it to the active window. $hget(testhash,$hfind(testhash,*user*,%i,w)) returns
; the data of the found item.
echo -a $hfind(testhash,*user*,%i,w) => [[$hget]](testhash,$hfind(testhash,*user*,%i,w))
; increase the looping-variable
[[inc]] %i
}

[[Category:Hash Table]]

$hfind - Revision history

Vliedel at 13:05, 3 February 2011

Doomie: changed example a little bit

Doomie at 20:27, 20 November 2005