Global List - Find

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:
Action Category:
Action List Syntax:

114
Global List
<<VARIABLE>>
= GlobalList[<<LISTNAME>>].Find (<<SEARCHTEXT>>)

Settings

Target List

Name:

The name of the Global List you want to search in.

Find

Item text:

The item text to search for. This must be the complete text of the item.

Start after position:

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.

Case sensitive search:

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

Store index in 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.

Error Codes

Value
(%LastErrorNum%)

Simple Message
(%LastErrorMsg%)

Verbose Message
(%LastErrorDetails%)

0 (OK)

 

 

1

MSG_ERR_GLOBAL_LIST_FIND

MSG_ERR_GLOBAL_LIST_FIND
MSG_ERR_OBJECT_NOT_FOUND
<<LISTNAME>>

Examples

Verifying a password

Verifying a password (advanced)