Retrieve item: Difference between revisions
imported>PhilmASTErpLus Whoops, forgot to type rest of the code. |
imported>Bale acquireable non-discardable items. |
||
| Line 39: | Line 39: | ||
special=Unlike a few other ASH commands, retrieve_item() will still return false on attempts to acquire items that are not possible to get (such as a sparkly engagement ring).| | special=Unlike a few other ASH commands, retrieve_item() will still return false on attempts to acquire items that are not possible to get (such as a sparkly engagement ring).| | ||
more_info=For information on order of operations, see [[Retrieval order]].| | more_info=For information on order of operations, see [[Retrieval order]].| | ||
special=This function and it's CLI equivalent "acquire" will not purchase items from the mall that can not be discarded. This is because many of those items are surprisingly expensive. Such items can be detected by checking to see if their {{f|autosell_price}} is 0. There are a few hard-coded exceptions to this rule: clovers, phials, divine favors, love songs and white rice can all be purchased with this command despite not being discardable.| | |||
}} | }} | ||
{{RFI|Are there exceptions to the info listed under Special?}} | {{RFI|Are there exceptions to the info listed under Special?}} | ||
[[Category:Item Management]]|[[Category:Adventuring]] | [[Category:Item Management]]|[[Category:Adventuring]] | ||
Revision as of 21:22, 15 July 2010
Function Syntax
boolean retrieve_item(int qty ,item get )
- qty is the quantity to acquire
- get is the item to acquire
Uses KoLmafia's internal logic to gather the items in the least destructive manner. Returns true if items are acquired as specified and false if not.
Code Sample
This is an example of a very simple aftercore logout script.
item nightcap = $item[ Mon Tiki ];
while (my_inebriety() <= inebriety_limit())
{
if ( !retrieve_item( 1 , nightcap ) )
abort( "Could not make/buy a " + nightcap + " for a nightcap." );
else
overdrink( 1 , nightcap );
}CLI Equivalent
The CLI command "acquire" works similarly.
See Also
More Information
For information on order of operations, see Retrieval order.
Special
This function and it's CLI equivalent "acquire" will not purchase items from the mall that can not be discarded. This is because many of those items are surprisingly expensive. Such items can be detected by checking to see if their autosell_price() is 0. There are a few hard-coded exceptions to this rule: clovers, phials, divine favors, love songs and white rice can all be purchased with this command despite not being discardable.
Attention KoLmafia Experts!
We need your help; some details of this function's operation are unknown or unclear.
The following specific question has been raised:
- Are there exceptions to the info listed under Special?
|