Editing mirc/identifiers/$hget

{{mirc title|$hget identifier}}'''$hget''' returns informations about hash tables


== Synopsis ==
<pre>$hget(name/N) - returns the name if the hash table exist or Nth name
$hget(name/N, item, [&binvar]) - returns the data associated with the item</pre>

== Parameters ==
* '''name/N''' - the Nth hash table or the name of it
* '''item''' - the name of the item you want the data of
* '''&binvar''' - if you provide a binvar as a third parameter, the associated data is copied at the beginning of the binvar and the binvar is chopped at length of the associated data (what was before in the binvar is 'deleted' before copying)

== Properties ==
* '''.unset''' - When passing an item, you can use the .unset property to get the unset time of the item if any
* '''.state''' - Return some internal informations about the table. The format returned is 3 tokens space separated, the first word is the number of items in the table, the second is in the format <nbr_used_buckets>/<totalnbr_buckets>, while the third consists of four number separated by a slash as well, but it's unknown what they really mean.
* '''.hash''' - Return the name of the algorithm used by the hash table, which can be passed using the -h switch in {{mIRC|/hmake}}
* '''.data''' - returns the contents of the hash table item.

== Example ==
<pre>//hadd -m test test test | echo -a $hget(test,test) | hfree test</pre>

== Compatibility ==
{{mIRC compatibility|5.8}}

= See also =
* {{mIRC|/hmake}}
* {{mIRC|/hadd}}
* {{mIRC|/hload}}
* {{mIRC|/hfree}}
* {{mIRC|/hdec}}
* {{mIRC|/hinc}}
* {{mIRC|$hfind}}
{{mIRC identifier list}}

[[Category:mIRC identifiers]]