llGetStatus

function

Function syntax

integer llGetStatus(

integer status// Single STATUS_* flag to check. Values: ObjectStatusParam

);

Returns: integer
Energy: 10

Returns a boolean integer indicating whether the specified status flag status is enabled for the object.

Returns an integer equal to the status of the object.

integer result = llGetStatus(0);

Specification

Constants	Value	Default	Description
`STATUS_PHYSICS`	0x001	`FALSE`	Object is physical
`STATUS_ROTATE_X`	0x002	`TRUE`	Can turn along this axis (physical objects only)
`STATUS_ROTATE_Y`	0x004	`TRUE`	Can turn along this axis (physical objects only)
`STATUS_ROTATE_Z`	0x008	`TRUE`	Can turn along this axis (physical objects only)
`STATUS_PHANTOM`	0x010	`FALSE`	Object is phantom
`STATUS_SANDBOX`	0x020	`FALSE`	Keep object within 10 meters and in the same region
`STATUS_BLOCK_GRAB`	0x040	`FALSE`	Prevent click-and-drag movement on the root prim

Constants	Value	Default	Description
`STATUS_DIE_AT_EDGE`	0x080	`FALSE`*	Delete and do not return object if it goes off world
`STATUS_RETURN_AT_EDGE`	0x100	`FALSE`	Return object to owner if it goes off world
STATUS_CAST_SHADOWS	0x200	`TRUE`	not currently used
`STATUS_BLOCK_GRAB_OBJECT`	0x400	`FALSE`	Prevent click-and-drag movement on all prims in the object
`STATUS_DIE_AT_NO_ENTRY`	0x800	`FALSE`†	Delete and do not return object if it cannot enter a parcel

^{* STATUS_DIE_AT_EDGE - If the object is rezzed by a script, the default is TRUE}

^{† STATUS_DIE_AT_NO_ENTRY - No-copy objects ignore this flag and remain in-world}

Caveats

Status is an object attribute; all prims in an object share the same status.
STATUS_BLOCK_GRAB only really deals with the root prim. Try STATUS_BLOCK_GRAB_OBJECT instead.
Querying for STATUS_CAST_SHADOWS always returns FALSE regardless of the setting.
Only one flag should be specified at a time. As of Second Life Server 2022-09-09.574921, if more than one flag is specified, STATUS_DIE_AT_NO_ENTRY takes priority, followed by STATUS_BLOCK_GRAB_OBJECT, STATUS_DIE_AT_EDGE, STATUS_RETURN_AT_EDGE, STATUS_BLOCK_GRAB, STATUS_SANDBOX, STATUS_ROTATE_Z, STATUS_ROTATE_Y, STATUS_ROTATE_X, STATUS_PHANTOM, and STATUS_PHYSICS.

Examples

Example 1

default
{
    touch_start(integer total_number)
    {
        if (llGetStatus(STATUS_PHYSICS))
        {
            llSay(0, "This object is physical");
        }
        else
        {
            llSay(0, "This object is not physical");
        }
    }
}

Known issues

From the issue templates included by the wiki article:

SVC-5531 (bug): llGetStatus(STATUS_ROTATE_Z); will not work on child prims on freshly rezzed objects.
SVC-1773 (bug): STATUS_BLOCK_GRAB only affects individual prims in a linkset
SVC-4197 (fs): Create STATUS_TRANSLATE_* flags for llSetStatus