TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-229
#LINEFIND Built-In Function
#LINEFIND Built-In Function
Use #LINEFIND to find text in a variable level, searching forward 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.
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
#LINEFIND returns the number of the line in which text begins. If text is not found, or if
text is empty, #LINEFIND returns zero.
Considerations
•
If line-addr is past the end of the variable level, #LINEFIND returns zero.
•
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 begins immediately at the line number specified. If you make repeated
calls to this function, using the result of each as a starting point for the next, you
must add 1 to that result before supplying it to a subsequent call.
•
If line-addr is empty, #LINEFIND returns zero.
#LINEFIND [ / EXACT / ] variable-level line-addr text