Command Reference - Global List Actions
Returns the index of a Global List item that matches the search criteria. If no matching item is found, this action returns -1 instead.
|
Action ID: |
114 |
Target List
The name of the Global List you want to search in.
Find
The item text to search for. This must be the complete text of the item.
The zero-based position in the Global List that the search will begin after. For example, if you specify position 5, the search will begin starting with position 6 in the Global List. (more info)
Use -1 to search the Global List from the beginning. (The first item in the Global List is at position 0; in order to include that item in the search, we have to tell the action to start searching after position -1.)
|
NOTE |
|
|
|
|
|
For most other actions, -1 is used to signify the end of something. Don't let this confuse you; the "Global List - Find" action is a special case. |
Controls whether the search will be performed in a case sensitive manner. When this option is enabled, the case of an item will have to match the text in the Item text field exactly in order to be considered a match.
Variable
The variable that you want the index of the matching item to be stored in. This variable will receive a value of -1 if no matching item is found.
|
Value |
Simple Message |
Verbose Message |
|
0 (OK) |
|
|
|
1 |
MSG_ERR_GLOBAL_LIST_FIND |
MSG_ERR_GLOBAL_LIST_FIND |