llListFindList
Revision as of 06:44, 17 August 2009 by EddyFragment Robonaught (talk | contribs) (added info clarifying the return of the last (if found) index not being -1)
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.
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: integer llListFindList( list src, list test );| 201 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns an integer that is the index of the first instance of test in src.
| • list | src | |||
| • list | test |
If test is not found in src, -1 is returned.
The index of the first entry in the list is 0
If test is found at the last index in src the positive index is returned (5th entry of 5 returns 4).
Caveats
Examples
<lsl>list numbers = [1, 2, 3, 4, 5]; default {
state_entry()
{
integer index = llListFindList(numbers, [3]);
if (index != -1)
{
list three_four = llList2List(numbers, index, index + 1);
llOwnerSay(llDumpList2String(three_four, ","));
// Object: 3,4
}
}
}</lsl>
Useful Snippets
An easy way to see if an item exists in a list... <lsl>if(~llListFindList(myList, (list)item)) {//it exists
//This works because ~(-1) == 0 //It saves bytecode and is faster then doing != -1
}</lsl>
See Also
Functions
| • | llSubStringIndex | – | Find a string in another string | |
| • | List: Find Last Index | – | Returns an integer that is the index of the last instance of test in src. | |
| • | List: Multi-Find Index (First_or_Last) | – | Get first(or last) Index of any matching elements of test in src. |