STR_FIND

Use the STR_FIND script function to search for a character or a string in a string. The search is not case sensitive.

Syntax

STR_FIND (String1, String2[, Start])

Parameters

STR_FIND
Searches for a characters or a string in a string
String1
An alphanumeric string in which you want to search
Format: script literal or script variable
String2
A single character or an alphanumeric string that your search for.
Format: script literal or script variable
Start
(Optional) Position where the search should start. The script function looks for String2 in String1. If not defined, the search begins at the first position.
Format: number without quotation marks
Default value: 1

Return codes

Position where the character or string was found
Note: The script function returns the first position where the search found the character or string defined in String2. The system counts the position starting with the beginning of String1 and not with the position specified in Start.
0
The character or string could not be found

Examples

The following script returns the position within a string where a given string is found.

:SET &LOCATION# = STR_FIND("AE system", "system")

The result is 4 because the first character of the search term is the fourth character in the string.

In the following example, the search for the # character in the Automic#01, Automic#02 strings returns the value 8:

:SET &STRING#="Automic#01, Automic#02"
:SET &SEARCHSTRING#="#"
:SET &POS#=STR_FIND(&STRING#,&SEARCHSTRING#)
:PRINT &POS#

In the following example, the search starts at position 2, so the position of the term that you search for is at 13.

:SET &POS#=STR_FIND("AUTOMIC#01, AUTOMIC#02","AUTOMIC", 2)

:PRINT &POS#