View source for Put.v

The '''put.v''' command indirectly sets the [[OBJECT File (AGI)|room number]] value for an [[inventory item]].

== Syntax ==

put.v([[variable|var]] vITEM, [[variable|var]] vROOMNUM);

== Remarks ==

The [[OBJECT File (AGI)|room number]] for [[inventory item]] '''iA''', where '''A''' = '''vITEM''', is changed to '''B''', where '''B''' = '''vROOMNUM'''. If the new room number is 255, it signifies the item being in the player's 'inventory'; you could use the '''[[get.v]]''' command instead.

Changing an inventory item's room number does not actually 'move' the item.

== Possible Errors ==

If the [[inventory item]] is not valid (the number exceeds the total number of inventory items in the [[OBJECT File (AGI)|OBJECT]] file), AGI will raise [[trappable error #23]].

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
v220 = 25;
v221 = 30;
put.v(v220, v221);  [  item i25's room number is now 30
</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:'''
| 96 (0x60 hex)
|}

== See Also ==

[[Inventory Item Commands]]<br />
'''[[put]]'''<br />
'''[[get]]'''<br />
'''[[get.v]]'''<br />
[[Category:Commands]]<br />