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


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.


Created with the Personal Edition of HelpNDoc: Create HTML Help, DOC, PDF and print manuals from 1 single source