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.

If called on an area, it returns the area itself. So, if OBJECT_SELF is an area, (GetArea(OBJECT_SELF)==OBJECT_SELF)

Version

1.62

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);
}