Walking Through Inventory Items

Requires OBSE

There are two ways to walk an inventory:

1. From the end to the beginning - Easier to use with RemoveItem, but slower
2. From beginning to end - faster

From the End to the Beginning

short InvPos
ref pInvObj
ref pCont
...
set pCont to YourDesiredContainer
set InvPos to pCont.GetNumItems
Label
if InvPos
  set InvPos to (InvPos - 1)
  set pInvObj to (pCont.GetInventoryObject InvPos)
  ;Do whatever you want to do
  Goto
endif

From the Beginning to the End

short InvPos
ref pInvObj
ref pCont
...
set pCont to YourDesiredContainer
set InvPos to 0
Label
set pInvObj to (pCont.GetInventoryObject InvPos)
if pInvObj
  set InvPos to (InvPos + 1)
  ;Do whatever you want to do
  Goto
endif

Notes

• GetInventoryObject returns the base object FormID. It can't be used when a reference should be used. The information returned about it (i.e., using GetSoulLevel) will be about the base object and not necessarily each object in the player's inventory. That is, if the player has 2 petty soul gems, one filled and the other empty and you use GetSoulLevel it will return the same for both (empty).
• Can be used for both containers and actors.

• Some common things to do with the item
• Run tests such as
if (IsQuestItem pInvObj) if (pInvObj == Apple)
• Find out how many the player has
set InvObjCount to (pCont.GetItemCount pInvObj)
• If you are using more than 1 Label/Goto in your script you may need to use an ID for them. See Label or GoTo for more information.

See Also

• GetInventoryObject
• Label
• GetNumItems