$hget » History » Revision 3
Revision 2 (Per Amundsen, 08/11/2015 05:43 AM) → Revision 3/9 (Per Amundsen, 03/17/2016 11:00 PM)
_Added in 1.9.0_
*$hget(name|N)*
Returns name of a hash table if it exists, or returns the name of the Nth hash table.
*Parameters*
name|N - Name of the hashtable or If N = 0, number of hashtables, otherwise the Nth hashtable name.
*Properties*
.size - Returns the size of the hashtable as specified in [[/hmake]]. (in AdiIRC returns the actual size of the table)
*Example*
<pre>
; Create a hashtable.
/hmake Example
; Print number of hashtables.
//echo -ag $hget(0)
; Print name and size of the first hashtable.
//echo -ag $hget(1) - $hget(1).size
</pre>
-----------------------------------------------------------------------------
*$hget(name|N, item|N, [&binvar])*
Returns the data associated with an item in the specified hash table.
*Parameters*
name|N - Name of the hashtable or the Nth hashtable name.
item|N - Name of the item or if N = 0 number of items, otherwise the Nth item.
*Properties*
.data - Returns the item value.
.item - Returns the item name.
.unset - Returns number of seconds before the item is automatically removed (if set).
[&binvar] - TODO
*Example*
<pre>
; Create a hashtable
/hmake Example
; Add a item to the hashtable
/hadd Example ExampleItem ExampleValue
; Print number of items in the hastable.
//echo -ag $hget(Example, 0)
; Print information about the first item in the hashtable.
//echo -ag Name is $hget(Example, 1).item Value is $hget(Example, 1).data Unset at $hget(Example, 1).unset
</pre>