llList2Vector

From Second Life Wiki
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: vector llList2Vector( list src, integer index );

Returns a vector that is at index in src.

• list src List containing the element of interest.
• integer index Index of the element of interest.

index supports negative indexes.
If index describes a location not in src then ZERO_VECTOR is returned.
If the type of the element at index in src is not a vector then ZERO_VECTOR is returned.
Here is a workaround: (vector)llList2String(src, index);

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.
  • When used to typecast from a string it will result in a ZERO_VECTOR
    • A true typecast will solve this: (vector)llList2String(src, index);
      • Unfortunately, if it was already a vector type, using llList2String will cause the decimal values to be truncated to six decimal places.
      • In any string representation of a vector such as llList2String(src, index), or (string) llList2Vector (src, index), spaces are automatically added after the commas. When received by a listen, make sure NOT to parse by spaces.
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 = ~llGetListLength(my_list);
        while(++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

Functions

•  llGetListEntryType
•  llList2String

Articles

•  Negative Index

Deep Notes

All Issues

~ Search JIRA for related Issues
   Perform typecasting with all llList2* functions

Signature

function vector llList2Vector( list src, integer index );