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
|
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.
|
Created with the Personal Edition of HelpNDoc: Modernize your help files with HelpNDoc's WinHelp HLP to CHM conversion tool