WoW:API GetMerchantItemInfo: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
m (Added second category link.)
m (Move page script moved page API GetMerchantItemInfo to API GetMerchantItemInfo without leaving a redirect)
 
(6 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<center>'''GetMerchantItemInfo''' - ''Documentation by [[User:Fenaoin|Fenaoin]]''</center>
{{wowapi}} __NOTOC__
 
== Synopsis ==
Returns information about a merchant's item.
Returns information about a merchant's item.
name, texture, price, quantity, numAvailable, isUsable, extendedCost = GetMerchantItemInfo(index)


name, texture, price, quantity, numAvailable, isUsable = GetMerchantItemInfo(index)
==Parameters==
 
=== Arguments ===
== Arguments ==
:(index)
 
:;index : Number - The index of the item in the merchant's inventory
:;index : Number - The index of the item in the merchant's inventory
 
=== Returns ===
== Returns ==
:name, texture, price, quantity, numAvailable, isUsable
 
:;name : String - The name of the item
:;name : String - The name of the item
:;texture : String - The texture that represents the item's icon
:;texture : String - The texture that represents the item's icon
:;price : Number - The price of the item (in copper)
:;price : Number - The price of the item (in copper).  Note that if quantity is greater than one (i.e. the item is sold in batches by default), then this is the price per batch, not the unit price.
:;quantity : Number - The quantity that will be purchased
:;quantity : Number - The quantity that will be purchased (the ''batch size'', e.g. 5 for vials)
:;numAvailable : Number - The number of this item that the merchant has in stock. -1 for unlimited stock.
:;numAvailable : Number - The number of this item that the merchant has in stock. -1 for unlimited stock.
:;isUsable : Number - Is 1 if the player can use this item, nil otherwise
:;isUsable : Number - Is 1 if the player can use this item, nil otherwise
:;extendedCost : Number - Is 1 if the item has extended (PvP) cost info, nil otherwise


== Example ==
== Example ==
:Let's say that we want to get info about the item in slot 4. The item is an alchemy recipe that costs 18 silver and the player does not have a high enough skill to use it yet. The item is in limited supply and 2 are in stock.
  local name, texture, price, quantity, numAvailable, isUsable, extendedCost = GetMerchantItemInfo(4);
<!-- begin code -->
message(name .. " " .. price .. "c");
  local name, texture, price, quantity, numAvailable, isUsable = GetMerchantItemInfo(4);
=== Result ===
<!-- end code -->
A message stating the name and price of the item in merchant slot 4 appears.
==== Result ====
==See also==
:In this case, we would get:
*[[API GetMerchantItemCostInfo|GetMerchantItemCostInfo]]
<!-- begin code -->
name         -&gt; Recipe: Great Rage Potion
texture      -&gt; Interface\Icons\INV_Scroll_03
price       -&gt; 1800
quantity    -&gt; 1
numAvailable -&gt; 2
isUsable    -&gt; nil
<!-- end code -->
----
__NOTOC__
{{Template:WoW API}}
[[Category:API Item Functions|GetMerchantItemInfo]]
[[Category:API Merchant Functions|GetMerchantItemInfo]]

Latest revision as of 04:46, 15 August 2023

← WoW API < GetMerchantItemInfo

Returns information about a merchant's item. 

name, texture, price, quantity, numAvailable, isUsable, extendedCost = GetMerchantItemInfo(index)

Parameters[edit]

Arguments[edit]

index
Number - The index of the item in the merchant's inventory

Returns[edit]

name
String - The name of the item
texture
String - The texture that represents the item's icon
price
Number - The price of the item (in copper). Note that if quantity is greater than one (i.e. the item is sold in batches by default), then this is the price per batch, not the unit price.
quantity
Number - The quantity that will be purchased (the batch size, e.g. 5 for vials)
numAvailable
Number - The number of this item that the merchant has in stock. -1 for unlimited stock.
isUsable
Number - Is 1 if the player can use this item, nil otherwise
extendedCost
Number - Is 1 if the item has extended (PvP) cost info, nil otherwise

Example[edit]

local name, texture, price, quantity, numAvailable, isUsable, extendedCost = GetMerchantItemInfo(4);
message(name .. " " .. price .. "c");

Result[edit]

A message stating the name and price of the item in merchant slot 4 appears.

See also[edit]

Retrieved from "https://addonstudio.org/mw/index.php?title=WoW:API_GetMerchantItemInfo&oldid=19132"