Mall price - Revision history

Philmasterplus at 15:28, 31 December 2020

2020-12-31T15:28:01Z

← Older revision		Revision as of 15:28, 31 December 2020
Line 2:		Line 2:
	\|name=mall_price		\|name=mall_price
	\|function1.return_type=int		\|function1.return_type=int
	\|function1.description=Returns the current mall price of ~~the given~~ item		\|function1.description=Returns the current (lowest) mall price of an item.
	\|function1.param1=shop_for		\|function1.param1=shop_for
	\|function1.param1.type=item		\|function1.param1.type=item

Philmasterplus: Add missing return type

2020-12-31T15:24:32Z

Add missing return type

← Older revision		Revision as of 15:24, 31 December 2020
Line 1:		Line 1:
	<onlyinclude>{{{{{format\|Function2}}}		<onlyinclude>{{{{{format\|Function2}}}
	\|name=mall_price		\|name=mall_price
	\|function1.return_type=		\|function1.return_type=int
	\|function1.description=Returns the current mall price of the given item		\|function1.description=Returns the current mall price of the given item
	\|function1.param1=shop_for		\|function1.param1=shop_for

Philmasterplus: Convert to Template:Function2 format, use Template:SeeAlso/Mall Prices, add JS sample code

2020-12-31T15:24:06Z

Convert to Template:Function2 format, use Template:SeeAlso/Mall Prices, add JS sample code

← Older revision		Revision as of 15:24, 31 December 2020
Line 1:		Line 1:
	{{		<onlyinclude>{{{{{format\|Function2}}}
	~~#vardefine:name\|mall_price}}~~{{		\|name=mall_price
	~~#vardefine:return_type~~\|~~int~~}}{{		\|function1.return_type=
			\|function1.description=Returns the current mall price of the given item
	~~FunctionPage~~\|		\|function1.param1=shop_for
	name=~~{{#var:name}}~~\|		\|function1.param1.type=item
			\|function1.param1.description=Item to search for
	function1=~~{{Function~~\|		\|description=
	~~name~~=~~{{#var:name}}\|~~		Returns the current mall price of the given item, ignoring the first five items listed to compensate for stores with limits and min-priced sales. To prevent abuse, this will only perform an actual Mall search once per item per session; subsequent calls for the same item will return a cached value. The cache will be updated after attempts to purchase the item using the CLI or ASH {{f\|buy}} command (even unsuccessful ones), but not in ''any'' other conditions, including purchasing with the purchase tab.
	~~aggregate={{#var:aggregate}}~~\|		\|code1={{CodeSample
	~~return_type~~=~~{{#var:return_type}}\|~~		\|title=Code Samples
	~~return_also={{#var:return_also}}~~\|		\|description=Creates Mae Wests based on your stills remaining. Puts the created items into your shop, pricing them using {{f\|mall_price}}.
	~~parameter1~~=~~{{Param\|~~item\|~~shop_for}}\|~~		\|code=
	~~p1desc~~=~~{{Pspan\|shop_for}} is the item~~ to ~~inquire on the mall price of\|~~		{{{!}} class="wikitable"
	}}\|		! style="width: 45%" {{!}} ASH
			! style="width: 55%" {{!}} JavaScript
	~~function_description=~~Returns the current mall price of the given item, ignoring the first five items listed to compensate for stores with limits and min-priced sales. To prevent abuse, this will only perform an actual Mall search once per item per session; subsequent calls for the same item will return a cached value. The cache will be updated after attempts to purchase the item using the CLI or ASH {{f\|buy}} command (even unsuccessful ones), but not in ''any'' other conditions, including purchasing with the purchase tab.\|		{{!}}- style="vertical-align: top"
			{{!}}
			<syntaxhighlight lang="d" line highlight="8">
			if ( stills_available() > 1 ) {
			set_property( "promptAboutCrafting", 0 );
			int stills_left = floor( stills_available() / 2 );
			create( stills_left, $item[ Mae West ] );
			print( `Created {stills_left} Mae West.`, "blue" );
			set_property( "promptAboutCrafting", 1 );
			put_shop(
			mall_price( $item[ Mae West ] ),
			0,
			item_amount( $item[ Mae West ] ),
			$item[ Mae West ]
			);
			}
			</syntaxhighlight>
			{{!}}
			<syntaxhighlight lang="js" line highlight="18">
			const {
			create,
			itemAmount,
			mallPrice,
			print,
			putShop,
			setProperty,
			stillsAvailable,
			} = require("kolmafia");

	~~code1~~=~~{{CodeSample\|~~		const MAE_WEST = Item.get("Mae West");
	~~title=Code Samples\|~~		if (stillsAvailable() > 1) {
	~~description=Creates Mae Wests based on your stills remaining~~. ~~Puts the created items into your shop, pricing them using the mall_price~~() ~~command.\|~~		setProperty("promptAboutCrafting", "0");
	~~code=~~		let stillsLeft = Math.floor(stillsAvailable() / 2);
	~~<syntaxhighlight>~~		create(stillsLeft, MAE_WEST);
	if (~~stills_available~~() > 1) {		print("Created " + stillsLeft + " Mae West.", "blue");
	~~set_property~~("promptAboutCrafting", 0);		setProperty("promptAboutCrafting", 1);
	~~int stillsleft;~~		putShop(mallPrice(MAE_WEST), 0, itemAmount(MAE_WEST), MAE_WEST);
	~~stillsleft~~ = floor(~~(stills_available~~()/2));
	create(~~stillsleft~~, ~~$item[Mae West]~~);
	print("Created " + ~~stillsleft~~ + " Mae West.", "blue");
	~~set_property~~("promptAboutCrafting", 1);
	~~put_shop~~(~~mall_price~~(~~$item[Mae West]~~), 0, ~~item_amount~~(~~$item[Mae West]~~), ~~$item[Mae West]~~);
	}		}
	</syntaxhighlight>\|		</syntaxhighlight>
	~~moreinfo=~~		{{!}}}
	~~Mall_price() is best used when the exact price of the item is needed. See historical_price() for theorizing.~~		\|moreinfo=
	~~}}\|~~

	~~see_also=~~{{~~SeeAlso\|historical_price\|buy\|retrieve_item~~}}\|
	~~cli_equiv=The CLI command "searchmall" also returns current mall prices.~~\|
	~~special~~=~~Untradeable items will return 0 without any server requests. Items not listed in the mall will return -1. When not logged in, this function returns -1 for all items.\|~~
	}}		}}
			\|see_also={{SeeAlso/Mall Prices}}
			\|cli_equiv=
			\|more_info=
			\|special=
			\|{{{1\|}}}
			}}</onlyinclude>
	[[Category:Item Management]]		[[Category:Item Management]]

Eliteofdelete at 14:21, 17 January 2015

2015-01-17T14:21:35Z

@@ Line 17: / Line 17: @@
 function_description=Returns the current mall price of the given item, ignoring the first five items listed to compensate for stores with limits and min-priced sales. To prevent abuse, this will only perform an actual Mall search once per item per session; subsequent calls for the same item will return a cached value. The cache will be updated after attempts to purchase the item using the CLI or ASH {{f|buy}} command (even unsuccessful ones), but not in ''any'' other conditions, including purchasing with the purchase tab.|
-needscode=yes|
+code1={{CodeSample|
 see_also={{SeeAlso|historical_price|buy|retrieve_item}}|

Idran: Updating return data based on recent results

2012-03-14T06:38:10Z

Updating return data based on recent results

← Older revision		Revision as of 06:38, 14 March 2012
Line 21:		Line 21:
	see_also={{SeeAlso\|historical_price\|buy\|retrieve_item}}\|		see_also={{SeeAlso\|historical_price\|buy\|retrieve_item}}\|
	cli_equiv=The CLI command "searchmall" also returns current mall prices.\|		cli_equiv=The CLI command "searchmall" also returns current mall prices.\|
	special=Items not listed in the mall will return ~~0 (untradeable items will return 0 without any server requests)~~. When not logged in, this function returns -1.\|		special=Untradeable items will return 0 without any server requests. Items not listed in the mall will return -1. When not logged in, this function returns -1 for all items.\|
	}}		}}

	[[Category:Item Management]]		[[Category:Item Management]]

Bale: more detail on how mall_price value can be updated

2011-05-24T23:10:36Z

more detail on how mall_price value can be updated

← Older revision		Revision as of 23:10, 24 May 2011
Line 15:		Line 15:
	}}\|		}}\|

	function_description=Returns the current mall price of the given item, ignoring the first five items listed to compensate for stores with limits and min-priced sales. To prevent abuse, this will only perform an actual Mall search once per item per session; subsequent calls for the same item will return a cached value. The cache will be updated after attempts to purchase the item (even unsuccessful ones), but not in any other conditions.\|		function_description=Returns the current mall price of the given item, ignoring the first five items listed to compensate for stores with limits and min-priced sales. To prevent abuse, this will only perform an actual Mall search once per item per session; subsequent calls for the same item will return a cached value. The cache will be updated after attempts to purchase the item using the CLI or ASH {{f\|buy}} command (even unsuccessful ones), but not in ''any'' other conditions, including purchasing with the purchase tab.\|

	needscode=yes\|		needscode=yes\|

Slyz: mall-price() does only one mall search per item per session

2011-05-24T14:06:00Z

mall-price() does only one mall search per item per session

← Older revision		Revision as of 14:06, 24 May 2011
Line 15:		Line 15:
	}}\|		}}\|

	function_description=Returns the current mall price of the given item, ignoring the first five items listed to compensate for stores with limits and min-priced sales. ~~This function runs a new check each time it is called~~, ~~so if you call~~ this ~~function and then purchase some of {{pspan\|shop_for}} in~~ the ~~mall, calling this function again~~ will return ~~the new price of~~ the item, ~~again ignoring the first five~~.\|		function_description=Returns the current mall price of the given item, ignoring the first five items listed to compensate for stores with limits and min-priced sales. To prevent abuse, this will only perform an actual Mall search once per item per session; subsequent calls for the same item will return a cached value. The cache will be updated after attempts to purchase the item (even unsuccessful ones), but not in any other conditions.\|

	needscode=yes\|		needscode=yes\|

PhilmASTErpLus: A bit of information about untradeable items.

2010-08-26T01:25:23Z

A bit of information about untradeable items.

← Older revision		Revision as of 01:25, 26 August 2010
Line 21:		Line 21:
	see_also={{SeeAlso\|historical_price\|buy\|retrieve_item}}\|		see_also={{SeeAlso\|historical_price\|buy\|retrieve_item}}\|
	cli_equiv=The CLI command "searchmall" also returns current mall prices.\|		cli_equiv=The CLI command "searchmall" also returns current mall prices.\|
	special=Items not listed in the mall will return 0. When not logged in, this function returns -1.\|		special=Items not listed in the mall will return 0 (untradeable items will return 0 without any server requests). When not logged in, this function returns -1.\|
	}}		}}

	[[Category:Item Management]]		[[Category:Item Management]]

Bale at 21:49, 21 May 2010

2010-05-21T21:49:43Z

← Older revision		Revision as of 21:49, 21 May 2010
Line 5:		Line 5:
	FunctionPage\|		FunctionPage\|
	name={{#var:name}}\|		name={{#var:name}}\|
	~~function_category=Item Management\|~~

	function1={{Function\|		function1={{Function\|
Line 24:		Line 23:
	special=Items not listed in the mall will return 0. When not logged in, this function returns -1.\|		special=Items not listed in the mall will return 0. When not logged in, this function returns -1.\|
	}}		}}

			[[Category:Item Management]]

Bale at 23:09, 5 May 2010

2010-05-05T23:09:26Z

← Older revision		Revision as of 23:09, 5 May 2010
Line 20:		Line 20:
	needscode=yes\|		needscode=yes\|

	see_also={{SeeAlso\|buy\|retrieve_item}}\|		see_also={{SeeAlso\|historical_price\|buy\|retrieve_item}}\|
	cli_equiv=The CLI command "searchmall" also returns current mall prices.\|		cli_equiv=The CLI command "searchmall" also returns current mall prices.\|
	special=Items not listed in the mall will return 0. When not logged in, this function returns -1.\|		special=Items not listed in the mall will return 0. When not logged in, this function returns -1.\|
	}}		}}