Project

General

Profile

Hinc » History » Version 3

Per Amundsen, 12/30/2018 11:46 PM

1 1 Per Amundsen
_Added in 1.9.0_
2
3 3 Per Amundsen
*/hinc [-bcmsuNzB] <name> <item> [num | &binvar]*
4 1 Per Amundsen
5
Increases the value of the item by 'num'.
6
7
*Switches*
8
9 2 Per Amundsen
-b - indicates &binvar is set.
10
-c - chop the &binvar to first null byte.
11 1 Per Amundsen
-m - creates the table if it does not exist.
12 2 Per Amundsen
-s - displays the result.
13 1 Per Amundsen
-uN - unsets the item after N seconds.
14
-z - decreases the item once per second until it reaches zero and then unsets it.
15 3 Per Amundsen
-B - Performs a [[$calcint]] calculation instead of regular [[$calc]] when arithmetic operators are used. (AdiIRC only)
16 1 Per Amundsen
17
*Parameters*
18
19
<name> - The hashtable where the <item> is stored.
20
<item> - The hashtable item to increase.
21
[num | &binvar] - The number or &binvar to increase by.
22
23
*Example*
24
25
<pre>
26
alias example {
27
  ;Create a hashtable.
28
  /hmake -s example
29
 
30
  ;Add a few items.
31
  /hadd example item1 4
32
  /hadd example item2 7
33
  /hadd example item3 9
34
 
35
  ;Print the items.
36
  /echo -a item1 = $hget(example, item1)
37
  /echo -a item2 = $hget(example, item2)
38
  /echo -a item3 = $hget(example, item3)
39
 
40
  ;Increase the values.
41
  /hinc example item1 5
42
  /hinc example item2 12
43
  /hinc example item3 1
44
  
45
  /echo -e -
46
 
47
  ;Print the items.
48
  /echo -a item1 = $hget(example, item1)
49
  /echo -a item2 = $hget(example, item2)
50
  /echo -a item3 = $hget(example, item3)
51
 
52
  ;Cleanup.
53
  /hfree -s example
54
}
55
</pre>