Difference between revisions of "LlListFindList"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Rolig Loon (talk | contribs) |
|||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{Issues/SVC-5146}} | |inject-2={{Issues/SVC-5146}}{{Issues/BUG-10924}} | ||
|func=llListFindList | |func=llListFindList | ||
|func_id=201|func_sleep=0.0|func_energy=10.0 | |func_id=201|func_sleep=0.0|func_energy=10.0 | ||
| Line 21: | Line 21: | ||
* If {{LSLP|test}} is an {{HoverText|empty list|[]}} the value returned is {{HoverText|0|zero}} rather than -1. | * If {{LSLP|test}} is an {{HoverText|empty list|[]}} the value returned is {{HoverText|0|zero}} rather than -1. | ||
|constants | |constants | ||
|examples=< | |examples=<source lang="lsl2">list numbers = [1, 2, 3, 4, 5]; | ||
default | default | ||
{ | { | ||
| Line 34: | Line 34: | ||
} | } | ||
} | } | ||
}</ | }</source> | ||
< | <source lang="lsl2">//You can also search for two items at once to find a pattern in a list | ||
list avatarsWhoFoundMagicLeaves = ["Fire Centaur","Red Leaf"]; | list avatarsWhoFoundMagicLeaves = ["Fire Centaur","Red Leaf"]; | ||
default | default | ||
| Line 49: | Line 49: | ||
} | } | ||
} | } | ||
}</ | }</source> | ||
|helpers= | |helpers= | ||
An easy way to see if an item exists in a list... | An easy way to see if an item exists in a list... | ||
< | <source lang="lsl2">if(~llListFindList(myList, (list)item)) | ||
{//it exists | {//it exists | ||
// This works because ~(-1) produces 0, but ~ of any other value produces non-zero and causes the 'if' to succeed | // This works because ~(-1) produces 0, but ~ of any other value produces non-zero and causes the 'if' to succeed | ||
| Line 58: | Line 58: | ||
// It saves bytecode and is faster then doing != -1 | // It saves bytecode and is faster then doing != -1 | ||
// This is a bitwise NOT (~) not a negation (-) | // This is a bitwise NOT (~) not a negation (-) | ||
}</ | }</source> | ||
|also_functions= | |also_functions= | ||
{{LSL DefineRow||[[llSubStringIndex]]|Find a string in another string}} | {{LSL DefineRow||[[llSubStringIndex]]|Find a string in another string}} | ||
Latest revision as of 05:04, 16 December 2015
| 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 the integer index of the first instance of test in src.
| • list | src | – | what to search in (haystack) | |
| • list | test | – | what to search for (needle) |
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
- Strict type matching and case sensitivity is enforced.
- "1" != 1
- "1.0" != 1.0
- 1 != 1.0
- "a822ff2b-ff02-461d-b45d-dcd10a2de0c2" != (key)"a822ff2b-ff02-461d-b45d-dcd10a2de0c2"
- "Justice" != "justice"
- If test is an empty list the value returned is 0 rather than -1.
Examples
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
}
}
}
//You can also search for two items at once to find a pattern in a list
list avatarsWhoFoundMagicLeaves = ["Fire Centaur","Red Leaf"];
default
{
state_entry()
{
integer index = llListFindList(avatarsWhoFoundMagicLeaves, ["Fire Centaur","Red Leaf"]);
if (index != -1)
{
list output = llList2List(avatarsWhoFoundMagicLeaves, index, index + 1);
llOwnerSay(llDumpList2String(output, ","));
// Object: Fire Centaur, Red Leaf
}
}
}
Useful Snippets
An easy way to see if an item exists in a list...
if(~llListFindList(myList, (list)item))
{//it exists
// This works because ~(-1) produces 0, but ~ of any other value produces non-zero and causes the 'if' to succeed
// So any return value (including 0) that corresponds to a found item, will make the condition succeed
// It saves bytecode and is faster then doing != -1
// This is a bitwise NOT (~) not a negation (-)
}
See Also
Functions
| • | llSubStringIndex | – | Find a string in another string |
Deep Notes
All Issues
~ Search JIRA for related Issues
|
|
SVC-5146 | A | llSortedListFindList() - improved llListFindList() for known to be sorted lists | |
|
|
|
BUG-10924 | A | llSubListFindList() - Search within a sub-list |
Signature |
|---|
function integer llListFindList( list src, list test ); |
Haiku |
|---|
|
Where are my car keys?
|