GetArea(object)

Returns the area oTarget is currently in.

object GetArea(
    object oTarget
);

Parameters

oTarget

The area that the target is located.

Description

Returns the area that oTarget is currently in where oTarget can be a PC, creature, or placeable.

Returns OBJECT_INVALID on any error.

Remarks

If the area for a known creature is invalid, it is probably in limbo! Doing anything to it when it is in limbo may well crash the game (especially DelayCommanded actions).

If a PC's area is invalid, it can only be in an area tansition - almost like Limbo - and may also cause a crash if thier action queue is edited, or so on.

Modules and Area's will, of course, return OBJECT_INVALID.

Version

1.22

Example

// Get the are of the script caller. If this is an area or module, 
// it will obviously be invalid!
void main()
{
    // Define the oArea object variable.
    object oArea;

    // Get the area of the script caller.
    oArea = GetArea(OBJECT_SELF);
}