View source for Mall prices

<onlyinclude>{{{{{format|Function2}}}
|name=mall_prices
|function1.return_type=int
|function1.description=Updates the mall price for a category of items, and returns the number of items searched.
|function1.param1=category
|function1.param1.type=string
|function1.param1.description=Item category (must be exact match)
|function1.param2=tiers
|function1.param2.type=string
|function1.param2.optional=yes
|function1.param2.default=""
|function1.param2.description=String containing item quality tiers. Only relevent if {{pspan|category}} is a consumable category (<code>food</code>, <code>booze</code>, or <code>othercon</code>)
|function2.return_type=int
|function2.description=Updates the mall price for a set of items, and returns the number of items searched.
|function2.param1=items
|function2.param1.type={{type|boolean}} {{opt|{{type|item}}}}
|function2.param1.description=Items to search for. This can be constructed using the <code>$items[]</code> plural-typed constant.
|description=
The set-based version can be used to search for multiple items at once, so that calling {{f|mall_price}} later on individual items won't trigger server requests. This can be useful when your script needs to retrieve the price of multiple items, but do not want the search results to be interleaved with the script's output.

The category-based version can be used to update the price of a whole category of items while making a minimal number of server requests. Depending on the number of items in the category, this will make anywhere between 20 and 80 requests.

The category search uses KoL's mall item categories. Valid category values include:

* <code>allitems</code>: All items ('''WARNING: This will take very long''')
* <code>food</code>: Food and Beverages
* <code>booze</code>
* <code>othercon</code> (Other consumables)
* <code>weapons</code>
* <code>hats</code>
* <code>shirts</code>
* <code>container</code> (Back items)
* <code>pants</code>
* <code>acc</code> (Accessories)
* <code>offhand</code>
* <code>combat</code> (Combat items)
* <code>potions</code>
* <code>hprestore</code> (HP Restorers)
* <code>mprestore</code> (MP Restorers)
* <code>familiars</code> (Familiar hatchlings)
* <code>mrstore</code> (Mr. Store Items)
* <code>unlockers</code> (Content Unlockers)
* <code>new</code> (New Stuff)

{{pspan|tiers}} can be any string that contains a consumable tier name. Valid tier names are: <code>crappy</code>, <code>decent</code>, <code>good</code>, <code>awesome</code>, <code>EPIC</code>. Tier names are are case-sensitive.

KoLmafia does not care what separator you use, or if you use a separator at all. For example, both <code>"crappy, decent, good"</code> and <code>"crappydecentbooze"</code> will search for crappy/decent/good consumables. However, we recommend using proper separators, as it will make your life easier.

The category-based search was added in [https://kolmafia.us/threads/18892-add-mall_prices-category-to-bulk-calculate-mall-prices-for-entire-categoriesu.23173/ r18892], and the optional {{pspan|tiers}} parameter was added in [https://kolmafia.us/threads/18893-add-two-argument-form-of-mall_prices-int-mall_prices-string-category-strin.23175/ r18893]. The item set search variant was added in [https://kolmafia.us/threads/18937-new-ash-function-int-mall_prices-boolean-item-to-look-up-the-curren.23234/ r18937].
|code1={{CodeSample
  |title=Code Samples
  |description=Find the 5 most expensive foods in the mall.
  |code=
{{{!}} class="wikitable"
! style="width: 50%" {{!}} ASH
! style="width: 50%" {{!}} JavaScript
{{!}}- style="vertical-align: top"
{{!}}
<syntaxhighlight lang="d" line highlight="1">
int food_count = mall_prices( "food" );
print( `{food_count} food prices retrieved.` );

item [int] food_list;
foreach it in $items[]
{
   // Items that are untradable or not available in the mall have a price of 0.
   // We will ignore such items.
   if ( item_type( it ) == "food" && mall_price( it ) > 0 )
   {
      // Add item to list
      food_list[ count(food_list) ] = it;
   }
}

// Sort the list by mall price, from highest to lowest
sort food_list by -mall_price( value );
// Print the name and price of first 5 items
for i from 0 to 5
{
   print( `{food_list[i].name}: {mall_price( food_list[i] )}` );
}
</syntaxhighlight>
{{!}}
<syntaxhighlight lang="js" line highlight="3">
const { mallPrice, mallPrices, print, itemType } = require("kolmafia");

const foodCount = mallPrices("food");
print(foodCount + " food prices retrieved.");

// Items that are untradable or not available in the mall have a price of 0.
// We will ignore such items.
const foodList = Item.all()
  .filter((it) => itemType(it) === "food" && mallPrice(it) > 0)
  .sort((a, b) => mallPrice(b) - mallPrice(a))  // Sort from highest to lowest
  .slice(0, 5);

for (let food of foodList) {
  print(food.name + ": " + mallPrice(food));
}
</syntaxhighlight>
{{!}}}
  |moreinfo=
}}
|code2={{CodeSample
  |description=Find the price of all elemental wads. Using {{f|mall_prices}} allows us to print the price of all pieces at once, without having KoLmafia print "Searching for <item name>..." between them.
  |code=
{{{!}} class="wikitable"
! style="width: 50%" {{!}} ASH
! style="width: 50%" {{!}} JavaScript
{{!}}- style="vertical-align: top"
{{!}}
<syntaxhighlight lang="d" line highlight="9">
boolean [ item ] wads = $items[
  cold wad,
  hot wad,
  sleaze wad,
  spooky wad,
  stench wad,
];

mall_prices( wads );

foreach wad in wads
{
   print( `{wad.name}: {mall_price( wad )}` );
}
</syntaxhighlight>
{{!}}
<syntaxhighlight lang="js" line highlight="12,16">
const { mallPrice, mallPrices, print } = require("kolmafia");

const wads = Item.get([
  "cold wad",
  "hot wad",
  "sleaze wad",
  "spooky wad",
  "stench wad",
]);

// For JavaScript, we must manually build an object whose keys are item names.
const wadsObj = {};
for (let wad of wads) {
  wadsObj[wad.name] = true;
}
mallPrices(wadsObj);

for (let wad of wads) {
  print(wad.name + ": " + mallPrice(wad));
}
</syntaxhighlight>
{{!}}}
  |moreinfo=
}}
|code3={{CodeSample
  |description=Find the price of all pieces of the {{kolwiki|Star Garb}} outfit. Since the return type of {{f|outfit_pieces}} and the parameter type of {{f|mall_prices}} is different, we must manually build a map of pieces.
  |code=
{{{!}} class="wikitable"
! style="width: 50%" {{!}} ASH
! style="width: 50%" {{!}} JavaScript
{{!}}- style="vertical-align: top"
{{!}}
<syntaxhighlight lang="d" line highlight="1,9">
boolean [ item ] pieces;
// Add items to the map
foreach key, piece in outfit_pieces( "Star Garb" )
{
   pieces[ piece ] = true;
}

// Perform a search at once
mall_prices( pieces );

foreach piece in pieces
{
   print( `{piece.name}: {mall_price(piece)}` );
}
</syntaxhighlight>
{{!}}
<syntaxhighlight lang="js" line highlight="4,11">
const { mallPrice, mallPrices, outfitPieces, print } = require("kolmafia");

const pieces = outfitPieces("Star Garb");
const piecesObj = {};
// Add items to the object
for (let piece of pieces) {
  piecesObj[piece.name] = true;
}

// Perform a search at once
mallPrices(piecesObj);

for (let piece of pieces) {
  print(piece.name + ": " + mallPrice(piece));
}
</syntaxhighlight>
{{!}}}
  |moreinfo=
}}
|see_also={{SeeAlso|}}
|cli_equiv=
|more_info=
|special=
|{{{1|}}}
}}</onlyinclude>
[[Category:Item Management]]