[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 FILECOPEN()
 Tests to see if the file is still open in the backup mode
------------------------------------------------------------------------------
 Syntax

     FILECOPEN() --> lOpenFile

 Returns

     FILECOPEN() returns .T. when all data is not copied during a  FILECOPY()
     or FILECCONT().

 Description

     FILE COPY OPEN
     FILECOPEN() determines whether all data is copied.  This concerns the
     source file, which is specified when the FILECOPY() function is called.
     FILECOPEN() returns .T. until all the data in the source file is read,
     whether by FILECOPY or the follow-on function FILECCONT()

 Note

     .  If you must abort the copy process, and FILECOPEN() continues
        to returns .T., use FILECCLOSE().

 Examples

     Show a back up with FILECOPY():

     nCounter   := 1                   // "BIG.001" etc.
     cTargetFile   := "BIG" + NTOC(nCounter, 10, 3, "0")
     FILECOPY("BIG.DBF", "A:\" + cTargetFile, .T.)
                                       // Back up mode
     DO WHILE FILECOPEN()
        DO NEXTDISK                    // Request disk change
        nCounter     := nCounter + 1
        cTargetFile  := "BIG" + NTOC(nCounter, 10, 3, "0")
        FILECCONT(cTargetFile)         // Next disk - new name

     ENDDO
     FILECCLOSE                        // For safety


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