TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-231
#LINEFINDR Built-In Function
#LINEFINDR Built-In Function
Use #LINEFINDR to find text in a variable level, searching backward from a specified
line number.
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.
line-addr
is an integer or a variable level that contains an integer. line-addr specifies the
line number at which the search is to begin. The line 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
#LINEFINDR returns the number of the line in which text begins. If text is not found or
text is empty, #LINEFINDR returns zero.
Considerations
•
If line-addr is past the end of the variable level, #LINEFINDR 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 spaces and end-
of- lines are ignored.
•
The search includes all of the specified line. The search finds a match if the
matching text begins anywhere within, or before, that line (even if the text extends
beyond the line). If you make repeated calls to this function, using the result of one
call as a starting point for the next, you must subtract one from that result before
using it in a subsequent call. This procedure avoids finding the same text again.
#LINEFINDR [ / EXACT / ] variable-level line-addr text