FIND—find character strings

The FIND command allows you to find a specified character string. The syntax of the FIND command is:


                                  .-NEXT--.  .-CHARS--.   
>>---FIND----string--+---------+--+-------+--+--------+--------->
                     +-UTF8----+  +-ALL---+  +-PREFIX-+   
                     +-ASCII---+  +-FIRST-+  +-SUFFIX-+   
                     '-USASCII-'  +-LAST--+  '-WORD---'   
                                  '-PREV--'               

>--+---------------------+-------------------------------------><
   '-left_col--right_col-'

Note: FIND as a Browse command, shown here, has the same syntax as FIND as an Edit command, except the optional X/NX/EX and line range operands are not included.

where:

string: Required operand. The character string you want to find.
NEXT | ALL | FIRST | LAST | PREV: Optional operands that define the starting point, direction, and extent of the search. NEXT is the default.
CHARS | PREFIX | SUFFIX | WORD: Optional operand. Operands that set the conditions for a character string match. CHARS is the default.
UTF8 | ASCII | USASCII: Optional operand which specifies that the FIND string is either a UTF8, ASCII, or USASCII character string. This form of the FIND command is only available for the character FIND command, and only for UTF8, ASCII, or USASCII strings.
left_col and right_col: Optional operands. Numbers that identify the columns the FIND command is to search.

You can separate the operands with blanks or commas and you can type them in any order, but right_col, if typed, must follow left_col.