GetRefs

A function added by the New Vegas Script Extender.

Description

Similar to using GetFirstRef and GetNextRef, and follows the same syntax. Returns an array containing all the references in the currently loaded cell(s), optional only of a specific form type. The optional cell depth argument specifies how many local cells to scan; passing -1 will use the uGridsToLoad value from Fallout.ini to calculate this. The included taken refs option will also return items that have been picked up. Added by NVSE 4.5.7.

Syntax

[help]

(array) GetRefs FormTypeCode:int CellDepth:int IncludeTakenRefs:bool

Example

; Simple example
array_var Cell_Refs

let Cell_Refs:= GetRefs

; Suppose you want all the actors currently loaded

array_var All_Actors

let All_Actors := GetRefs 200, -1

See Also

• GetRefsInCell (for cells other than the player's current)
• GetFirstRef / GetNextRef (the 'old' method)
• Foreach (Useful for looping through the returned array)
• Let
• Array Variables