Difference between revisions of "GetNumRefs - Cell"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>PurpleLunchbox
m
imported>JustinOther
(→‎Examples: Reworked example (kCell.CellFunction() vs. Cell.CellFunction())))
Line 22: Line 22:


== Examples ==
== Examples ==
<source lang="papyrus">
<source lang="papyrus">Function PickEveryFlowerInCell(Actor akFlowerPicker) Global
int numFlora = Cell.GetNumRefs(39) ; kFlora = 39
Cell kCell = akFlowerPicker.GetParentCell()
int index = 0
Int iIndex = kCell.GetNumRefs(39) ; kFlora = 39
While index < numFlora
While iIndex
ObjectReference objRef = Cell.GetNthRef(index, 39)
iIndex -= 1
Debug.Trace("Flora Found in cell: " + objRef)
kCell.GetNthRef(iIndex, 39).Activate(akFlowerPicker)
index += 1
EndWhile
EndWhile
EndFunction</source>
</source>


== See Also ==
== See Also ==

Revision as of 08:54, 22 January 2013

SKSE Member of: Cell Script

Returns the number of ObjectReferences in the Cell based on the FormType filter. (This function requires SKSE)

Syntax

int Function GetNumRefs(int formTypeFilter = 0) native

Parameters

  • formTypeFilter: FormType filter to return the number of a specific form type see GetType - Form for a list of FormTypes.

Return Value

Returns the number of ObjectReferences in the Cell based on the FormType filter.

Notes

  • Using a filter type of zero results in returning all object references in the cell.
  • If using a filter type make sure to use the same filter when retrieving the references.

Examples

Function PickEveryFlowerInCell(Actor akFlowerPicker) Global
	Cell kCell = akFlowerPicker.GetParentCell()
	Int iIndex = kCell.GetNumRefs(39) ; kFlora = 39
	While iIndex
		iIndex -= 1
		kCell.GetNthRef(iIndex, 39).Activate(akFlowerPicker)
	EndWhile
EndFunction

See Also