Skip to content
lsl.devlsl.devLSL Dev

llGetObjectLinkKey

View as MarkdownThis page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page
function
Function syntax
key llGetObjectLinkKey(
  1. key object_id,// UUID of the target prim or linkset.
  2. integer link// Link number (1 for root, >1 for children) or a LINK_* flag of the prim to retrieve. Values: Link
);
Returns
key
Energy
10

Returns the key (UUID) of the linked child prim specified by link within the linkset identified by object_id.

How to use
key result = llGetObjectLinkKey(NULL_KEY, 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.
// 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.


            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.