Difference between revisions of "Put shop"

From Kolmafia
Jump to navigation Jump to search
imported>StDoodle
m
imported>StDoodle
m
Line 33: Line 33:
  
 
function_description=Places items in your mall store with settings as described above. Returns true if placement is successful and false if placement fails.</p>
 
function_description=Places items in your mall store with settings as described above. Returns true if placement is successful and false if placement fails.</p>
<p>Note that this function will fail and return false if you try to put items in your store below minimum mall value.|
+
<p>Note that attempting to put an item in your store at less than minimum mall price will automatically reset the price to mall minimum.</p>
 +
<p>Note that attempting to put a negative amount of an item in your store will not do anything, but will still return true.</p>
 +
<p>Note that you cannot specify a quantity of 0 to change prices, but the function will still return true.|
  
 
code1={{CodeSample|
 
code1={{CodeSample|
 
title=Code Sample|
 
title=Code Sample|
description=The following example will put all of your broken skulls in your mall store for 500 meat.|
+
description=The following example will put all of your broken skulls in your mall store for 500 meat at a limit of 5.|
 
code=
 
code=
 
<syntaxhighlight>
 
<syntaxhighlight>
//code
+
put_shop(500 , 5 , $item[broken skull]);
 
</syntaxhighlight>}}|
 
</syntaxhighlight>}}|
  
see_also={{SeeAlso|FIRST|SECOND|ETC}}|
+
see_also={{SeeAlso|have_shop|shop_amount}}|
 
cli_equiv=The CLI command "mallsell" works similarly.|
 
cli_equiv=The CLI command "mallsell" works similarly.|
 
}}
 
}}

Revision as of 22:15, 1 March 2010



Function Syntax

boolean put_shop(int price ,int limit ,item it )

boolean put_shop(int price ,int limit ,int qty ,item it ,DATATYPE SHORT_DESC )

  • price is the price to set; using 0 will result in the max-price of 999,999,999 if item is not currently in your store
  • limit is the limit per player per day, or no limit if set to 0
  • qty an optional parameter for the quantity of items to put in your shop (defaults to all if not provided)
  • it is the item to put in your mall store.

Places items in your mall store with settings as described above. Returns true if placement is successful and false if placement fails.

Note that attempting to put an item in your store at less than minimum mall price will automatically reset the price to mall minimum.

Note that attempting to put a negative amount of an item in your store will not do anything, but will still return true.

Note that you cannot specify a quantity of 0 to change prices, but the function will still return true.

Code Sample

The following example will put all of your broken skulls in your mall store for 500 meat at a limit of 5.

put_shop(500 , 5 , $item[broken skull]);

CLI Equivalent

The CLI command "mallsell" works similarly.

See Also

have_shop() | shop_amount()