Unofficial LSL Reference

[[functions:llsamegroup]]


Unofficial LSL reference

User Tools

Login

You are currently not logged in! Enter your authentication credentials below to log in. You need to have cookies enabled to log in.

Login

Forgotten your password? Get a new one: Set new password

This is an old revision of the document!


Function: llSameGroup

Parameters

id

The key of a user or a prim in the same region.

Result

Returns TRUE if the user defined by id has the same group active that the object with this script is assigned to, or deeded to, or if the object of key id is assigned to the same group. Returns FALSE if the user or object is not currently in the same region, or if the assigned group differs.

Notes

  • This function will also return TRUE if the user/object of key id has no active group, and the prim containing the script is not assigned to any group.
  • TRUE is also returned if this object is not assigned to any group, and the function is called with NULL_KEY.
  • An object MAY be constructed from several prims each assigned to a different group. However, if the built object is then assigned to a new group, each component prim will be reassigned.

Short examples

integer Same = llSameGroup(llGetOwner() ); // Same will be TRUE if the object owner's currently active group is the same as that which the touched prim is assigned to, and the owner is currently in the region.

Complete examples

llSameGroup-example.lsl
default
{
    touch_start(integer count)
    {
        key UserKey =  llDetectedKey(0);
        if (! lllSameGroup(UserKey)
            llRegionSayTo(UserKey, 0, "Please activate the correct group in order to use this device");
        else
            llGiveInventory(UserKey, "FreeGift");
    }
}

See also