TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-235

#LINEFINDV Built-In Function

Use #LINEFINDV to find a string in a variable level, searching forward from a specified

line.

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 in which TACL will search for string. 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.

string

is the string constant or the name of a variable level that contains text. string

specifies the characters to be found. It must not be in a shared segment or be a

DIRECTORY, a STRUCT, or a STRUCT item. The largest valid string length is

32,000 words minus the current contents of the stack. The amount of remaining

space is typically 25,000 words long.

Result

#LINEFINDV returns the number of the line in which string begins. If string is not found

or the string is empty, #LINEFINDV returns zero. If variable-level is empty, then

#LINEFINDV returns zero.

Considerations

If line-addr is past the end of the variable level, #LINEFINDV returns zero. The

search starts immediately at the beginning of the line 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.

#LINEFINDV [ / EXACT / ] variable-level line-addr string