POS function

The first string argument (string-1) is a string value whose position within the second string argument is to be determined. The second string argument (string-2) is the string value to be searched for the first string argument.

Both string arguments can be string constants, single-element string variables, or string array elements.

Either the first or the second string argument (but not both) can be a string expression or a string function.

The value returned by the POS function is the position within string-2 of the first character of the first occurrence (from left to right) of a substring equal to string-1. For internal string values, counting begins at character position 1.

If string-1 does not equal a substring of string-2, the POS function returns a value of zero.

The intermediate result of the POS function is stored in an accumulator with a precision of 16.8 If this result is then stored in a receiving numeric variable, its precision is adjusted to the defined precision of that variable.

X = POS(A$,B$)

For example, if A$ equals "AT" and B$ equals "SIGNATURE", then the POS function will return a value of 5 (the starting position of the string "AT" within the value "SIGNATURE".)

VALUE = POS(STR$,"ABCDEF")

For example, if STR$ equals "B", the function will return a value of 2 (since "B" is in the second position of the string constant).

Or, if STR$ equals "Z", the function will return a value of zero, since "Z" is not contained in the constant.

Also, if STR$ equals "DE", the function will return a value of 4 (the substring "DE" starts at the fourth position of the constant).

N = POS("SMITH",NAME$)

Note: If "SMITH" is not found in the variable NAME$, the POS function will return a value of zero. This programming technique can be useful for determining if a particular string value is contained within a specific data field.