[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 FILECCONT()
 Copies sections of a file in backup mode
------------------------------------------------------------------------------
 Syntax

     FILECCONT(<cFile>) --> nCopyByte

 Argument

     <cFile>  Designates the file name for the target file.

 Returns

     FILECCONT() returns the number of bytes copied.

 Description

     FILE COPY CONTINUE
     Use this function primarily after a FILECOPY().  As much as possible of
     the remaining data is written to a new disk.  If the remaining data
     still does not fit on the designated target disk, call this function
     repeatedly until it writes all the remaining data.  Each time you call
     FILECCONT(), a new name can be designated for the target file.  These
     files are then numbered consecutively (see Examples).

 Notes

     .  If a copy procedure on multiple disks terminates for any
        reason, call FILECCLOSE().

     .  Use SETFCREATE() to designate an attribute to form a new file.

     .  The function acknowledges the CSETSAFETY() implementation, as
        does FILECOPY()

 Example

     Show a back up with FILECOPY().  After terminating, close the source
     file:

     FILECOPY(cSource, cTarget, .T.)   // Back up mode
     DO NEXTDISK                       // When terminated  Terminated = .T.
     DO WHILE FILECOPEN() .AND. .NOT. Terminated
        FILECCONT(cTarget)             // Next disk, new name
        DO NEXTDISK                    // Request for disk exchange
     ENDDO
     IF Terminated
        FILECCLOSE()                   // Close source file!
     ENDIF


See Also: FILECOPY() FILECOPEN() FILECCLOSE() FILECDATI()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson