View source for Addv

The '''addv''' command adds the values of two variables, and stores the result in the first variable.
== Syntax ==
addv([[variable|var]] vA, [[variable|var]] vB);<br />
vA = vA + vB;<br />
vA += vB;<br />

== Remarks ==
Because [[variable|variables]] are 8 bit unsigned numbers, if the result of the addition exceeds 255, the result 'wraps around'. For example, if v50 currently equals 200, and v51 has a value of 60, the statement: 

<CODE>addv(v50, v51);</code>

will result in a value for v50 of 4 (200 + 60 = 260; 260 - 256 = 4). This can be represented mathematically as vA = (vA + vB) % 0x100.

== Possible Errors ==
None.

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
v50 = 100;
v51 = 100;
addv(v50, v51);   [ v50 now equals 200
v50 = v50 + v51;  [ v50 now equals 44 (300 - 256)
v50 += v51;       [ v50 now equals 144
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in all AGI versions.
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 6 (0x06 hex)
|}

== See Also ==

[[Mathematical Commands]]<br />
'''[[addn]]'''<br />

[[Category:Commands]]