Difference between revisions of "GetFirstRefInCell"
Jump to navigation
Jump to search
imported>QQuix (Recent (!?!) OBSE function) |
imported>QQuix m (Fixed OBSE version)) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{Function | |||
| origin = OBSE | |||
| summary = Works the same as [[GetFirstRef]] but takes an additional parameter specifying the cell to scan. | |||
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. | Use [[GetNextRef]] to iterate through the rest of the references in the cell. | ||
| returnVal = reference | |||
| returnType = ref | |||
| arguments = | |||
<pre>ref pDoor | {{FunctionArgument | ||
| name = cell | |||
| type = ref | |||
}}{{FunctionArgument | |||
| name = type | |||
| type = int | |||
| optional = y | |||
}}{{FunctionArgument | |||
| name = cellDepth | |||
| type = int | |||
| optional = y | |||
}}{{FunctionArgument | |||
| name = includeInactiveRefs | |||
| type = bool | |||
| optional = y | |||
}} | |||
| example = <pre>ref pDoor | |||
... | ... | ||
set pDoor to GetFirstRefInCell AbandonedMine 24 | set pDoor to GetFirstRefInCell AbandonedMine 24 | ||
| Line 18: | Line 31: | ||
loop</pre> | loop</pre> | ||
Scans the list of doors in the AbandonedMine cell. | Scans the list of doors in the AbandonedMine cell. | ||
| CategoryList = [[Category:Functions]] | |||
[[Category:Functions (OBSE)]] | |||
[[Category:Functions (OBSE v0016)]] | |||
[[Category:Record Variable Functions]] | |||
[[Category:Record Variable Functions (OBSE)]] | |||
}} | |||
==Notes== | ==Notes== | ||
*If the specified cell is not loaded in memory: | *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 | *Ckeck the [[GetFirstRef]] article for additional details | ||
==See Also== | ==See Also== | ||
| Line 35: | Line 50: | ||
*[[HasBeenPickedUp]] | *[[HasBeenPickedUp]] | ||
*[[GetObjectType]] | *[[GetObjectType]] | ||
Latest revision as of 14:05, 8 June 2012
< [[::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.
Notes
- 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