Difference between revisions of "GetNumItems - ObjectReference"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>Zartar
m
imported>Zartar
m
Line 40: Line 40:
* The returned value indicates the number of item types in the container regardless of the count of any particular item. If a container has ten gold and a torch, GetNumItems will return '2' and not '11'.  
* The returned value indicates the number of item types in the container regardless of the count of any particular item. If a container has ten gold and a torch, GetNumItems will return '2' and not '11'.  


The exception is keys, if you have two of the same key then GetNumItems will count both keys. EDIT: This could be because the keys were quest items. More testing is needed to confirm this.
    The exception is keys, if you have two of the same key then GetNumItems will count both keys. EDIT: This could be because the keys were quest items. More testing is needed to confirm this.


== See Also ==
== See Also ==
*[[ObjectReference Script]]
*[[ObjectReference Script]]
*[[GetNthForm - ObjectReference|GetNthForm]]
*[[GetNthForm - ObjectReference|GetNthForm]]

Revision as of 17:14, 1 March 2013

SKSE Member of: ObjectReference Script

Minimum required SKSE Version: 1.05.01

Returns the number of items in a container. (This function requires SKSE)

Syntax

Int Function GetNumItems() Native

Return Value

Returns the number of items in a container.

Examples

  • Check a single container.
Int iNumItems = MQ101AlduinREF.GetNumItems()
  • Set the weights of all ingredients in player's inventory to 0.1.
Actor Property PlayerREF Auto

Event SomeEvent()
	ReweighIngredientsIn(PlayerREF, 0.1)
EndEvent

Function ReweighIngredientsIn(ObjectReference akContainer, Float afWeight) Global
	Int iFormIndex = akContainer.GetNumItems()
	While iFormIndex > 0
		iFormIndex -= 1
		Form kForm = akContainer.GetNthForm(iFormIndex)
		If kForm.GetType() == 30 ; Ingredient
			kForm.SetWeight(afWeight)
		EndIf
	EndWhile
EndFunction

Notes

  • The returned value indicates the number of item types in the container regardless of the count of any particular item. If a container has ten gold and a torch, GetNumItems will return '2' and not '11'.
   The exception is keys, if you have two of the same key then GetNumItems will count both keys. EDIT: This could be because the keys were quest items. More testing is needed to confirm this.

See Also