Core Function InStr

InStr( <string>, <substirng>, <casesense>, <occurrence>, <start>

Description

Checks if a string contains a given substring.

Parameters

string

The string to evaluate.

substring

The substring to search for.

casesense

Optional; Flag to indicate if the operations should be case sensitive.

0 = not case sensitive, using the user's locale (default)

1 = case sensitive

2 = not case sensitive, using a basic/faster comparison

Default: 0

occurrence

Optional; Which occurrence of the substring to find in the string. Use a negative occurrence to search from the right side.

The default value is 1 (finds first occurrence).

start

Optional; The starting position of the search.

Default: 0

Return Value

Success: Returns the position of the substring.

Failure: Returns 0 if substring not found or -1 if Invalid "occurance" parameter given.

Remarks

The first character position is 1.

Example

$location = InStr("How much wood could a woodchuck chuck is a woodchuck could chuck wood?", "wood", 0, 3);
Println("Search result:" , $location); // Find the 3rd occurance of "wood"
 
$result = InStr("I am a String", "RING");
Println("Search result:" , $result);