GetFirstRefInCell

< [[::Category:Functions|Category:Functions]]

A function added by the Oblivion Script Extender.

Syntax:

(reference:ref) GetFirstRefInCell cell:ref type:int cellDepth:int includeInactiveRefs:bool

Works the same as GetFirstRef but takes an additional parameter specifying the cell to scan.

Use GetNextRef to iterate through the rest of the references in the cell.

Example

ref pDoor
...
set pDoor to GetFirstRefInCell AbandonedMine 24 
while (pDoor)
  ; do something with pDoor
  set pDoor to GetNextRef
loop

Scans the list of doors in the AbandonedMine cell.

If the specified cell is not loaded in memory:
- Unloaded interior cells: this function will only return persistent references.
- Unloaded exterior cells: this function will not return any reference.
Ckeck the GetFirstRef article for additional details