FT_FINSERT() Inserts a line in the currently selected text file ──────────────────────────────────────────────────────────────────────────────
Syntax
FT_FINSERT( [ < nLines > ] ) -> NIL
Arguments
<nLines> is the number of lines that should be inserted at the current record position.
If <nLines> is omitted, one record is inserted.
Returns
NIL
Description
This function inserts a line of text in the file in the currently selected text file workarea. Text lines are delimited with a CRLF pair. The record pointer is not moved.
An optional parameter allows multiple insertions to take place with a single call to FT_FINSERT().
A text file "record" is a line of text terminated by a CRLF pair. Each line inserted with this function will be empty.
Examples
// add a blank line of text to a file FT_FUSE( "test.txt" )