LibBagUtils-1.0

Several useful bag related APIs that you wish were built into the WoW API:

 local LBU = LibStub("LibBagUtils-1.0")
 
 for bag,slot in LBU:Iterate("BANK", "Major Healing Potion") do
   LBU:PutItem("BAGS")
 end

:Iterate("which"[, "lookingfor"])

which

string: "BAGS", "BANK", "BAGSBANK"

lookingfor

OPTIONAL: itemLink, itemName, itemString or itemId(number). Will not match partial names.

Returns an iterator that can be used in a for loop, e.g.:

 for bag,slot,link in LBU:Iterate("BAGS") do   -- loop all slots
 for bag,slot,link in LBU:Iterate("BAGSBANK", 29434) do  -- find all badges of justice

:FindSmallestStack("where", "lookingfor"[, notLocked])

where

string: "BAGS", "BANK", "BAGSBANK"

lookingfor

itemLink, itemName, itemString or itemId(number)

notLocked

OPTIONAL: if true, will NOT return locked slots

Returns:

bag,slot,size or nil on failure

:PutItem("where"[, dontClearOnFail[, count]])

The easiest way to move items between bags and bank is of course to simply "click" them, but that doesn't work when you split stacks. That's when this function is handy.

PutItem is smart; it will try to use specialty bags before standard bags. (But it will not try to put e.g. herb bags in herb bags. Doh.)

where

string: "BAGS", "BANK", "BAGSBANK"

dontClearOnFail

OPTIONAL: boolean: If the put operation fails due to no room, do NOT clear the cursor. Default: false. (Note that some other wow client errors WILL clear the cursor)

count

OPTIONAL: number: if given, PutItem() will attempt to stack the item on top of another suitable stack. This is not possible without knowing the count, so if not given, it will simply be put in an empty slot.

Returns:

bag,slot or false for out-of-room.

If called without an item in the cursor, 0,0 will be returned (slot 0 does not exist)

:LinkIsItem(fullLink, lookingfor)

fullLink

string: A full item link as given by WoW APIs

lookingfor

string: itemLink, itemName, itemString or itemId(number). Will not match partial names.

Returns true if "lookingfor" matches "fullLink". Ignores in-constant info (e.g. level) in links.

• 

  Author

  Mikk

  (Project Manager)

  Downloads

  • WindowLib
  • ReadyCheckAnnouncer
  • LibWindow-1.1
  • LibBagUtils-1.0
  • IgnoreMore
  • FreeRefills
  • Finklestein daily serum quest helper
  • DragLib
  • ChatThrottleLib
  • Baggins_Search
  • Baggins_GarbageFu
  • Baggins_Auctioneer

------------------------------------------------------------------------
r4 | mikk | 2009-01-10 13:22:54 +0000 (Sat, 10 Jan 2009) | 1 line
Changed paths:
   A /tags/r3-release (from /trunk:3)

Tagging as r3-release
------------------------------------------------------------------------
r3 | mikk | 2008-11-27 15:52:17 +0000 (Thu, 27 Nov 2008) | 1 line
Changed paths:
   M /trunk/LibBagUtils-1.0/LibBagUtils-1.0.lua

This should be good for a first release
------------------------------------------------------------------------
r2 | mikk | 2008-11-23 10:38:54 +0000 (Sun, 23 Nov 2008) | 2 lines
Changed paths:
   A /trunk/LibBagUtils-1.0
   A /trunk/LibBagUtils-1.0/LibBagUtils-1.0.lua
   A /trunk/LibBagUtils-1.0/LibBagUtils-1.0.xml
   A /trunk/LibBagUtils-1.0.toc
   A /trunk/LibStub.lua

LibBagUtils-1.0: Initial checkin

------------------------------------------------------------------------
r1 | root | 2008-11-22 16:15:41 +0000 (Sat, 22 Nov 2008) | 1 line
Changed paths:
   A /branches
   A /tags
   A /trunk

"libbagutils-1-0/mainline: Initial Import"
------------------------------------------------------------------------