|
num-var = SPF_INS(line-ptr, col-num, data-str)
|
|
Operands:
|
line-ptr
|
the line pointer for the data line to be modified
|
|
|
col-num
|
the column number at which the str-var contents are to be inserted.
|
|
|
data-str
|
the text string to be inserted. This string may be entered as a list of comma delimited values. If so, they will be concatenated with a space between each entry.
|
|
Returns:
|
|
Both num-var and RC will be 0 and Msg$ will be "" (Null) for successful completion
Both num-var and RC will be 8 and Msg$ set to an error message on failure (e.g. invalid line pointer)
|
|
Special Notes:
|
|
Will insert str-var into the text of line-ptr at the indicated column col-num. Current text from col-num to the end of line will be shifted right to allow insertion of data-str. If needed, the line's text will be extended with blanks to col-num - 1 before data-str is copied in.
|