Use: Difference between revisions
Jump to navigation
Jump to search
imported>Bale mNo edit summary |
imported>Eliteofdelete No edit summary |
||
| Line 19: | Line 19: | ||
function_description=Attempts to use {{pspan|qty}} amount of item {{pspan|it}}. Returns true if the item is used or false if it fails to do so. Note that food must be "used" via eat() & drinks via drink(); attempting to use this function will result in an error message and a return value of false. Using this function for equipment will function the same as equip() would without the optional slot parameter. If this function is called with a non-usable item, a message saying so will print to the CLI and the function will return true.| | function_description=Attempts to use {{pspan|qty}} amount of item {{pspan|it}}. Returns true if the item is used or false if it fails to do so. Note that food must be "used" via eat() & drinks via drink(); attempting to use this function will result in an error message and a return value of false. Using this function for equipment will function the same as equip() would without the optional slot parameter. If this function is called with a non-usable item, a message saying so will print to the CLI and the function will return true.| | ||
code1={{CodeSample| | |||
title=Code Samples| | |||
description=The following example uses the festive warbear bank if you have one.| | |||
code= | |||
<syntaxhighlight> | |||
if (item_amount($item[festive warbear bank]) > 0) | |||
use(1, $item[festive warbear bank]); | |||
else print("You do not have a festive warbear bank.", "red"); | |||
</syntaxhighlight>| | |||
}}| | |||
see_also={{SeeAlso|drink|eat|equip}}| | see_also={{SeeAlso|drink|eat|equip}}| | ||
Revision as of 22:58, 21 January 2015
Function Syntax
boolean use(int qty ,item it )
- qty is the quantity to use
- it is the item to use
Attempts to use qty amount of item it. Returns true if the item is used or false if it fails to do so. Note that food must be "used" via eat() & drinks via drink(); attempting to use this function will result in an error message and a return value of false. Using this function for equipment will function the same as equip() would without the optional slot parameter. If this function is called with a non-usable item, a message saying so will print to the CLI and the function will return true.
Code Samples
The following example uses the festive warbear bank if you have one.
if (item_amount($item[festive warbear bank]) > 0)
use(1, $item[festive warbear bank]);
else print("You do not have a festive warbear bank.", "red");CLI Equivalent
The CLI command "use" functions similarly.
See Also
More Information
If qty is 0 or negative, no item will be used and the function will return true.