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" )

FT_FINSERT()

Source: FTTEXT.C

Author: Brice de Ganahl and Steve Larsen