llIsFriend

From Second Life Wiki
Revision as of 10:03, 15 November 2024 by Peter Stindberg (talk | contribs) (Bugfix in 2024-11-12.11802108395)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Summary

Function: integer llIsFriend( key agent_id );
0.0 Forced Delay
10.0 Energy

Returns a boolean (an integer) that is TRUE if agent_id and the owner of the prim the script is in are friends, otherwise FALSE.

• key agent_id

Specification

  • If the prim is owned by a group this function behaves identically to llSameGroup
  • This function will return FALSE under the following edge cases:
    • If neither the owner, nor the target agent are in the region.
    • If the agent_id does not specify an agent.

Caveats

  • You are not your own friend.
  • Currently a faulty result is given if the owner of the object the script resides in has moved to an adjacant region shortly before the query (see llIsFriend fails if owner is not present on region on Canny). First noticed on server version 2024-01-19.7590161929, last checked (and still not fixed) in server version 2024-09-13.10853867644. Fixed in server version 2024-11-12.11802108395.

Examples

default
{
    state_entry()
    {
        llSensorRepeat("", NULL_KEY, AGENT, 95, PI, 10);
    }

    sensor(integer count)
    {
        integer index;
        for (index = 0; index < count; ++index)
        {
            string is_is_not = " is NOT ";
            if (llIsFriend(llDetectedKey(index)))
            {
                is_is_not = " is ";
            }
            llSay(0, llDetectedName(index) + is_is_not + "a friend.");
        }
    }
}

See Also

Functions

•  llDetectedGroup
•  llSameGroup

Deep Notes

Signature

function integer llIsFriend( key agent_id );