Drop
From AGI Wiki
Revision as of 12:48, 30 March 2019 by Andrew Korson (talk | contribs) (Created page with "The '''drop''' command changes an inventory item's room number to zero. == Syntax == drop(itm iA); drop("item"); == Remarks == The '''drop''' comman...")
The drop command changes an inventory item's room number to zero.
Syntax
drop(itm iA); drop("item");
Remarks
The drop command is essentially a shortcut equivalent to using the put command with a new room number value of zero.
Note that there is not an equivalent 'variable' version of the drop command (i.e. no drop.v that takes a variable as an argument.)
Possible Errors
If the inventory item is not valid (the number exceeds the total number of inventory items in the OBJECT file), AGI will raise trappable error #23.
Example
Code:
<syntaxhighlight lang="agi"> drop(i30); [ item 30's room number is now 0 put(i30, 0); [ this also 'drops' an item </syntaxhighlight>
Technical Information
Required Interpreter Version: | Available in all AGI versions. |
Byte-Code Value: | 94 (0x5E hex) |