[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 FT_FINSERT()
 Inserts a line in the currently selected text file
------------------------------------------------------------------------------

 Syntax


      FT_FINSERT( [ < nLines > ] ) -> lSuccess

 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


     lSuccess is TRUE if the insert succeeded, FALSE if not.  If
     false check the return value of ft_fError() for the reason.

 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.

     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 couple of blank lines of text to a file
     ft fUse( "test.txt" )

     ft_fGoTo( 10 )

     ft_fInsert( 5 )


 Source: FTTEXT.C

 Author: Brice de Ganahl and Steve Larsen

See Also: FT_FAPPEND() FT_FRECNO() FT_FDELETE() FT_FLASTRE()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson