APPX Software Library

Chapter 4-8: Runtime Subroutine's and Predefined Processes

.TEXT FIND

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

Usage:

Screen capture

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> returns 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, <search_text> 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.