Skip to content
lsl.devlsl.devLSL Dev

llGetLinkKey

View as MarkdownThis page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page
function
Function syntax
key llGetLinkKey(
  1. integer link// Link number (1 for root, >1 for children) or a LINK_* flag. Values: Link
);
Returns
key
Energy
10

Returns the key (UUID) of the linked prim or avatar specified by link.

How to use
key result = llGetLinkKey(0);

Examples

Section titled “Examples”
Drag this script on to linked and unlinked prims, with avatars sitting or not, to see how llGetLinkKey relates to llGetKey, llGetLinkNumber, llGetNumberOfPrims, LINK_ROOT, etc.
26 collapsed lines
// Return the name of a link num else the empty string.
string getLinkNumName(integer link)
{
    if (LINK_THIS == link) return "LINK_THIS";
    if (LINK_ALL_CHILDREN == link) return "LINK_ALL_CHILDREN";
    if (LINK_ALL_OTHERS == link) return "LINK_ALL_OTHERS";
    if (LINK_SET == link) return "LINK_SET";
    if (LINK_ROOT == link) return "LINK_ROOT";
    return "";
}


// Say the key of each linked prim.
default
{
    state_entry()
    {
        integer theLink = llGetLinkNumber();


        key theLinkKey = llGetKey();
        key owner = llGetOwner();
        key creator = llGetCreator();


        // Visit each link num.


        integer link;
        integer primmed = llGetNumberOfPrims();
        for (link = -5; link <= (primmed + 5); ++link)
        {
            key linkKey = llGetLinkKey(link);


            // Detail the key at the link num.
28 collapsed lines


            string line = (string) linkKey; // large constant width


            if (linkKey == owner) line += " llGetOwner";
            if (linkKey == creator) line += " llGetCreator";
            if (linkKey == theLinkKey) line += " llGetKey";


            // Detail the link num.


            line += " @ " + (string) link;
            line += " " + getLinkNumName(link);
            if (link == theLink) line += " llGetLinkNumber";
            if (link == primmed) line += " llGetNumberOfPrims";


            // Say the detail if fun.


            if (linkKey != NULL_KEY)
            {
                llOwnerSay(line);
            }
        }


        // Always count the linked prims.


        llOwnerSay((string) primmed + " llGetNumberOfPrims");
        llOwnerSay("OK");
    }
}

Known issues

Section titled “Known issues”

From the issue templates included by the wiki article:

  • SVC-600 (bug): llGetLinkKey returns the wrong result when passed LINK_THIS
Section titled “Related functions”

The original wiki page documents these functions together with this one:

See also

Section titled “See also”

Functions

Section titled “Functions”
Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.