• This subroutine is designed to operate on Alpha, Text, and Token fields only. The returned results are undefined if you specify any other type of field.

.TEXT FIND

This subroutine finds the position of text in a text/alpha field.

Usage:

      PASS         <text_position>            FIELD            SHARE? Y
      PASS         <text_field>               FIELD            SHARE? N
      PASS         <search_text>              FIELD            SHARE? N
      PASS         <start_of_text>            FIELD            SHARE? N
      PASS         <len_of _text>             FIELD            SHARE? Y
      PASS         <start_of_search>          FIELD            SHARE? N
      PASS         <len_of _search>           FIELD            SHARE? Y
      GOSUB    --- .TEXT FIND
      *        Check for errors
*     IF       --- .TEXT FIND                 NE

Description:

This subroutine finds the position of text in a text/alpha field. The first 3 parameters are required. If any required parameters are missing, the subroutine will CANCEL.

<text_position> is the position of <search_text> within <text_field> (Required). This must be PASSed with Share "Y" to return the value.

<text_field> is the text to be searched (Required).

<search_text> is the text to be searched for (Required).

<start_of_text> is the starting position in <text_field> to begin the search (Optional). If not provided, <text_field> will be searched starting at position 1.

<len_of_text> is the number of characters from <start_of_text> to be searched (Optional). If not provided, <text_field> will be searched to the end of the field.

<start_of_search> is the starting position in <search_text> to use (Optional). If not provided, <start_of_search> starting at position 1 will be used.

<len_of_search> is the number of characters from <start_of_search> to be used (Optional). If not provided, <search_text> will be used to the end of the field.

Notes:

• The <text_position> returned is always from the start of <text_field>, even if you only searched a substring of <text_field>.
• This is a case sensitive search, regular expressions are not allowed.

Comments:

Read what other users have said about this page or add your own comments.

<--/commentPlugin-->

-- JeanNeron - 2012-02-09