# INSTR Function

#### Purpose:

To search for the first occurrence of string y$ in x$, and return the position at which the string is found.

#### Syntax:

    INSTR([n,]x$,y$)

#### Comments:

Optional offset n sets the position for starting the search. The default value for n is 1. If n equals zero, the error message "Illegal argument in line number" is returned. n must be within the range of 1 to 255. If n is out of this range, an "Illegal Function Call" error is returned.

INSTR returns 0 if:

- n > LEN(x$)
- x$ is null
- y$ cannot be found

If y$ is null, INSTR returns n.

x$ and y$ may be string variables, string expressions, or string literals.

#### Examples:

    10 X$="ABCDEBXYZ"
    20 Y$="B"
    30 PRINT INSTR(X$, Y$); INSTR(4, X$, Y$)
    RUN
     2 6

The interpreter searches the string "ABCDFBXYZ" and finds the first occurrence of the character B at position 2 in the string. It then starts another search at position 4 (D) and finds the second match at position 6 (B). The last three characters are ignored, since all conditions set out in line 30 were satisfied.