TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-239
#LINEGETV Built-In Function
#LINEGETV Built-In Function
Use #LINEGETV to copy a set of consecutive lines from one variable level to another.
string
is an existing variable level or quoted text from which characters are to be copied.
It must not be a DIRECTORY, a STRUCT, or a STRUCT item.
variable-level
is an existing variable level that is to receive the copy. The variable’s original
contents are lost, and its type is set to TEXT.
line-addr-1
is an integer or a variable level that contains an integer. line-addr-1 specifies
the line number at which copying is to begin. The line address must be in the range
from 1 to max-int, inclusive.
line-count
is an integer or a variable level that contains an integer. line-count specifies the
the number of lines to copy. The line count must be in the range from 0 to max-
int, inclusive.
line-addr-2
is an integer or a variable level that contains an integer. line-addr-1 specifies
the line number at which copying is to end. The line address must be in the range
from 0 to max-int, inclusive.
Result
#LINEGETV returns nothing.
Considerations
•
If you use TO, the line specified by line-addr-2 is included in the copy: That is,
“x TO y” is equivalent to “x FOR (y-x)+1.”
•
If you use TO and line-addr-1 is greater than or equal to line-addr-2, or if
you use FOR and line-countis less than one, no copying occurs.
•
If you omit both FOR and TO, one line is copied.
•
Any part of the specified copy that lies beyond the end of string is ignored.
#LINEGETV string variable-level line-addr-1
[ [ FOR line-count ] | [ TO line-addr-2 ] ]