llList2String

From Second Life Wiki
Revision as of 22:19, 21 June 2007 by Brangus Weir (talk | contribs) (Corrected example to avoid laggy construction)
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Summary

Function: string llList2String( list src, integer index );

Returns a string that is at index in src.

• list src
• integer index

index supports negative indexes. If the type of the entry at index in src is not a string it is typecast into a string.
If index is out of range it returns a null string.

Specification

Index Positive Negative
First 0 -length
Last length - 1 -1

Indexes

  • Positive indexes count from the beginning, the first item being indexed as 0, the last as (length - 1).
  • Negative indexes count from the far end, the first item being indexed as -length, the last as -1.

Caveats

  • If index is out of bounds the script continues to execute without an error message.
All Issues ~ Search JIRA for related Bugs

Examples

// Best viewed in Chat History (ctrl-h)
default
{
    state_entry()
    {
        list my_list = ["a", 1, 2.0, <1,2,3>, <1,2,3,4>, llGetOwner()];
        integer i;
        integer end;
        end = llGetListLength(my_list); //evaluate this ONCE do not check inside
                                        //the for loop.
                                        //for(i=0; i<llGetLIstLength(my_list); ++i)
                                        //is a bad programming practice (it's slow)
        for (i=0; i<end; ++i)
        {
            llOwnerSay("string=" + llList2String(my_list,i)
                        + "\n   integer=" + (string)llList2Integer(my_list,i)
                        + "\n   float=" + (string)llList2Float(my_list,i)
                        + "\n   vector=" + (string)llList2Vector(my_list,i)
                        + "\n   rot=" + (string)llList2Rot(my_list,i)
                        + "\n   key=" + (string)llList2Key(my_list,i) );
        }
    }
}

See Also

Articles

•  Negative Index

Deep Notes

Search JIRA for related Issues

Signature

function string llList2String( list src, integer index );