Difference between revisions of "LlGetNumberOfPrims"

From Second Life Wiki
Jump to navigation Jump to search
(state the caveat implicit in the examples: The number of prims returned includes the count of avatars sitting on the object.)
Line 7: Line 7:
|return_text=that is the number of prims in a link set the script is attached to.
|return_text=that is the number of prims in a link set the script is attached to.
|spec
|spec
|caveats
|caveats=*The number of prims returned includes the count of avatars sitting on the object.
|constants
|constants
|examples=Returns the number of agents on the object
|examples=Returns the number of agents on the object

Revision as of 03:38, 2 October 2007

Summary

Function: integer llGetNumberOfPrims( );
0.0 Forced Delay
10.0 Energy

Returns an integer that is the number of prims in a link set the script is attached to.

Caveats

  • The number of prims returned includes the count of avatars sitting on the object.

Examples

Returns the number of agents on the object

integer GetNumberOfAgents()
{//count avatars
    integer a = llGetNumberOfPrims();
    integer b = a;
    while(llGetAgentSize(llGetLinkKey(a)))
        --a;
    return b - a;
}

Useful Snippets

//Returns the number of agents on the object
integer GetNumberOfAgents()
{//count avatars
    integer a = llGetNumberOfPrims();
    integer b = a;
    while(llGetAgentSize(llGetLinkKey(a)))
        --a;
    return b - a;
}

//Returns the number of prims in the object
integer GetNumberOfPrims()
{//ignores avatars
    integer a = llGetNumberOfPrims();
    while(llGetAgentSize(llGetLinkKey(a)))
        --a;
    return a;
}

See Also

Functions

•  llGetObjectPrimCount Returns the number of prims in any object.
•  llGetLinkNumber Returns the link number of the prim the script is in.

Deep Notes

Signature

function integer llGetNumberOfPrims();