WoW:API GetContainerItemLink: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
No edit summary
 
m (Move page script moved page API GetContainerItemLink to API GetContainerItemLink without leaving a redirect)
 
(13 intermediate revisions by 12 users not shown)
Line 1: Line 1:
Sets the variable the item in (x, x) slot
{{wowapi}} __NOTOC__
 
 
<!-- Describe the purpose of the function, exhausting detail can be saved for a later section -->
Returns the  [[ItemLink]] of the item located in [[bagID]] and slotID.
 
<!-- List return values and arguments as well as function name, follow Blizzard usage convention for args -->
ItemLink = GetContainerItemLink(bagID, slotID)
 
 
== Parameters ==
=== Arguments ===
<!-- List each argument, together with its type -->
:bagID, slotID
 
:;[[bagID]] : Numeric - The number of the bag. Valid bags are -2 - 11. 0 is the backpack.
:;slotID : Numeric - The slot of the specified bag. Valid slotID's are 1 through BagSize. 1 is the left slot in the top row.
 
=== Returns ===
<!-- List each return value, together with its type -->
:ItemLink
 
:;[[ItemLink]] : Returns the [[ItemLink]] (The item link is the link when you shift-click an item while the chat edit box is visible). Returns nil if the slot of the specified bag is empty. Example link returned: '''|Hitem:6948:0:0:0:0:0:0:0|h[Hearthstone]|h''' . To use this link in other functions that require an [[ItemLink]], you have to strip out the extra chat link information.  Ex: '''item:6948:0:0:0:0:0:0:0'''
 
== Example ==
<!-- If it helps, include an example here, though it's not required if the usage is self-explanatory -->
function UseContainerItemByName(search)
  for bag = 0,4 do
    for slot = 1,GetContainerNumSlots(bag) do
      local item = GetContainerItemLink(bag,slot)
      if item and item:find(search) then
        UseContainerItem(bag,slot)
      end
    end
  end
end
 
====Result====
Searches through your bags and uses the first item found that contains the provided string in its name.
 
== Example ==
<pre>/run link=GetContainerItemLink(0,1);printable=gsub(link, "\124", "\124\124");ChatFrame1:AddMessage("Here's the item code for item in Bag slot 0,1: \"" .. printable .. "\"");</pre>
 
====Result====
Returns the  [[ItemLink]] of the item located in bag 0, slot 1.
 
== Example ==
<pre>/run _,_,itemLink=string.find(GetContainerItemLink(0,1),"(item:%d+)"); message(itemLink);</pre>
 
====Result====
Returns the abbreviated  [[ItemLink]] of the item located in bag 0, slot 1 (itemId only, useful for macros like "/use item:31339").
 
 
====Info====
===== for .. do =====
 
:Look for the 'for .. do' block at the [http://www.lua.org/manual/5.0/ Reference Manual].
 
===== GetContainerNumSlots(bagID) =====
 
:[[API GetContainerNumSlots|GetContainerNumSlots(bagID)]] - Gives you the number of slots available in the bag specified by the index.
 
===== UseContainerItem(bagID,slotID) =====
 
:[[API UseContainerItem|UseContainerItem(bagID,slot)]] - Uses an item located in [[bagID]] and slotID.
:''Bad example. UseContainerItem() is protected these days. --[[User:Mikk|<span style="border-bottom: 1px dotted; cursor: help;" title="Mikk is a WoWWiki Admin">Mikk</span>]] <small>([[User talk:Mikk|T]])</small> 06:20, 26 May 2007 (UTC)''
 
===== string.find(string,pattern{,init{,plain}}) =====
 
:[[API strfind|strfind(string,pattern{,init{,plain}})]] - Look for match of pattern in string, optionally from specific location or using plain substring.
 
[[Category:World of Warcraft API]]

Latest revision as of 04:45, 15 August 2023

← WoW API < GetContainerItemLink


Returns the ItemLink of the item located in bagID and slotID. 

ItemLink = GetContainerItemLink(bagID, slotID)


Parameters[edit]

Arguments[edit]

bagID, slotID
bagID
Numeric - The number of the bag. Valid bags are -2 - 11. 0 is the backpack.
slotID
Numeric - The slot of the specified bag. Valid slotID's are 1 through BagSize. 1 is the left slot in the top row.

Returns[edit]

ItemLink
ItemLink
Returns the ItemLink (The item link is the link when you shift-click an item while the chat edit box is visible). Returns nil if the slot of the specified bag is empty. Example link returned: |Hitem:6948:0:0:0:0:0:0:0|h[Hearthstone]|h . To use this link in other functions that require an ItemLink, you have to strip out the extra chat link information. Ex: item:6948:0:0:0:0:0:0:0

Example[edit]

function UseContainerItemByName(search)
  for bag = 0,4 do
    for slot = 1,GetContainerNumSlots(bag) do
      local item = GetContainerItemLink(bag,slot)
      if item and item:find(search) then
        UseContainerItem(bag,slot)
      end
    end
  end
end

Result[edit]

Searches through your bags and uses the first item found that contains the provided string in its name.

Example[edit]

/run link=GetContainerItemLink(0,1);printable=gsub(link, "\124", "\124\124");ChatFrame1:AddMessage("Here's the item code for item in Bag slot 0,1: \"" .. printable .. "\"");

Result[edit]

Returns the ItemLink of the item located in bag 0, slot 1.

Example[edit]

/run _,_,itemLink=string.find(GetContainerItemLink(0,1),"(item:%d+)"); message(itemLink);

Result[edit]

Returns the abbreviated ItemLink of the item located in bag 0, slot 1 (itemId only, useful for macros like "/use item:31339").


Info[edit]

for .. do[edit]
Look for the 'for .. do' block at the Reference Manual.
GetContainerNumSlots(bagID)[edit]
GetContainerNumSlots(bagID) - Gives you the number of slots available in the bag specified by the index.
UseContainerItem(bagID,slotID)[edit]
UseContainerItem(bagID,slot) - Uses an item located in bagID and slotID.
Bad example. UseContainerItem() is protected these days. --Mikk (T) 06:20, 26 May 2007 (UTC)
string.find(string,pattern{,init{,plain}})[edit]
strfind(string,pattern{,init{,plain}}) - Look for match of pattern in string, optionally from specific location or using plain substring.
Retrieved from "https://addonstudio.org/mw/index.php?title=WoW:API_GetContainerItemLink&oldid=18975"