TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-55
#CHARFINDR Built-In Function
#CHARFINDR Built-In Function
Use #CHARFINDR to find text in a variable level, searching backward from a character
address.
EXACT
specifies that the search is to be case-sensitive; if you omit it, the search makes no
distinction between uppercase and lowercase letters.
variable-level
is an existing variable level within which TACL will search for text. It must not be a
DIRECTORY, a STRUCT, or a STRUCT item.
char-addr
is an integer greater than zero or a variable level that contains an integer greater
than zero. char-addr specifies the character address at which the search is to
begin. The character address must be in the range from 1 to max-int, inclusive.
The search moves backward from this point.
text
is the text constant to be found. The largest valid text length is 32,000 words minus
the current contents of the stack. The amount of remaining space is typically
25,000 words long.
Result
#CHARFINDR returns the character address at which text begins. If text is not found,
#CHARFINDR returns zero.
Considerations
•
If char-addr is past the end of the variable level, #CHARFINDR starts the search
at the end of the contents of the variable.
•
A text specification can include internal end-of-line characters if the entire
invocation is enclosed in square brackets, but leading and trailing end-of-lines and
spaces are ignored.
•
The search begins immediately at the character address specified. Because the
search does not find a match unless the entire matching text appears at or before
char-addr, you must specify a starting address at the end of a variable level
(#CHARCOUNT or greater) to find text at the end of it.
•
If variable-level is empty, then #CHARFINDR returns zero.
#CHARFINDR [ / EXACT / ] variable-level char-addr text