OpenSim.Region.ScriptEngine.Shared.Api.LSL_Api.llGetLinkName C# (CSharp) Method

llGetLinkName() public method

Returns the name of the child prim or seated avatar matching the specified link number.
The rules governing the returned name are not simple. The only time a blank name is returned is if the target prim has a blank name. If no prim with the given link number can be found then usually NULL_KEY is returned but there are exceptions. In a single unlinked prim, A call with 0 returns the name, all other values for link number return NULL_KEY In link sets it is more complicated. If the script is in the root prim:- A zero link number returns NULL_KEY. Positive link numbers return the name of the prim, or NULL_KEY if a prim does not exist at that position. Negative link numbers return the name of the first child prim. If the script is in a child prim:- Link numbers 0 or 1 return the name of the root prim. Positive link numbers return the name of the prim or NULL_KEY if a prim does not exist at that position. Negative numbers return the name of the root prim. References http://lslwiki.net/lslwiki/wakka.php?wakka=llGetLinkName Mentions NULL_KEY being returned http://wiki.secondlife.com/wiki/LlGetLinkName Mentions using the LINK_* constants, some of which are negative
public llGetLinkName ( int linknum ) : OpenSim.Region.ScriptEngine.Shared.LSL_Types.LSLString
linknum int /// The number of a link in the linkset or a link-related constant. ///
return OpenSim.Region.ScriptEngine.Shared.LSL_Types.LSLString
        public LSL_String llGetLinkName(int linknum)
        {
            m_host.AddScriptLPS(1);

            ISceneEntity entity = GetLinkEntity(m_host, linknum);

            if (entity != null)
                return entity.Name;
            else
                return ScriptBaseClass.NULL_KEY;
        }
LSL_Api