Project

General

Profile

$hget » History » Revision 4

Revision 3 (Per Amundsen, 03/17/2016 11:00 PM) → Revision 4/9 (Per Amundsen, 06/14/2016 08:02 AM)

_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]]. 

 *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] - Assigns the contents of the item to a &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>