IFNSUBSTR        Branch to label if a substring not found in a master string

Top  Previous  Next

Syntax:

IFNSUBSTR

[ string ]  [ substring ]  GOTO  [ label ]

Alt Syntax:

IFNSUBSTRI

[ string ]  [ substring ]  GOTO  [ label ]

Arguments:

[ string ]

Variable or string defining master string.

 

[ substring ]

Variable or string defining substring to find.

 

[ label ]

A valid label within the current script file which is branched to if the substring is not contained within the master string.

Options:

none

 

 

 

This script command attempts to locate a substring with a specified master string and branches to [ label ] if it is not found.

 

Use the alternate IFNSUBSTRI command to perform the same comparison but to ignore case during the comparison. Unlike the UPPER and LOWER commands, IFNSUBSTRI does not change the case of the strings.

 

Consider the following simple example that results in a branch to the specified label.

 

SET master_string = "abcdefg"

SET substring = "xyz"

IFNSUBSTR master_string substring GOTO substring_not_found

 

 

Related command(s): IFSTRCMP, IFNSTRCMP, IFSUBSTR, UPPER, LOWER