num-var = SPF_OVR(line-ptr, col-num, data-str)

Operands:

line-ptr

the line pointer for the data line to be overlaid.


col-num

the column number at which the data-str contents are to be overlaid.


data-str

the new contents of the data line to be overlaid. 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 overlay text in line-ptr with data-str starting at the indicated column col-num. Other text in the line is unaffected. If needed, the line's text will be extended with blanks to col-num - 1 before data-str is copied in.


The overlay operation consists of replacing characters from data-str into the same relative location in the line's text only when there are blanks in the original data.


Compare the functionality of SPF_OVR to the O/OO edit line commands.