TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-241
#LINEINS Built-In Function
#LINEINS Built-In Function
Use #LINEINS to insert text into a variable level at a specified line number.
variable-level
is an existing variable level into which text will be inserted. It must not be in a
shared segment, and 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 text is to be inserted. The line address must be in the range
from 1 to max-int, inclusive.
text
is the text constant to be inserted. 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
#LINEINS returns nothing.
Considerations
•
A text specification can include internal end-of-lines if you enclose the entire
invocation in square brackets, but leading and trailing spaces and end-of-lines are
ignored.
•
If line-addrr is beyond the end of the variable level, the text is appended to the
end of the variable level, starting on a new line.
Examples
Assume that var is a variable level containing:
ABCDEFG
HIJKLMNOPQRST
UVWXYZ
1. The invocation:
#LINEINS var 3 NEW TEXT
causes var to contain:
ABCDEFG
HIJKLMNOPQRST
#LINEINS variable-level line-addr text