Functions and Directives Functions and Directives

Function FileCopy() Foundation

Copies files normally or in backup mode.

Syntax
FileCopy( <cSourceFile>  , ;
          <cTargetFile>  , ;
          [<lBackupMode>]  ;  // Default: .F.
        ) --> nBytesCopied
Return

Returns the number of bytes copied from <cSourceFile> to <cTargetFile>.

Description

<cTargetFile>

If this file does not exist it will be created. The setting FileCDaTi() determines which date/time the new file will have.

If <cTargetFile> does exist, it depends on the setting CsetSafety() whether or not the file will be overwritten.

<lBackupMode>

If this parameter is set .T. <cSourceFile> is opened in backup mode. This is used for copying a large file to diskettes when the file does not fit on a single diskette. FileCopy() copies the maximum possible number of bytes to the diskette. The function FileCOpen() is used to check whether <cSourceFile> is still open. If this is the case the user can be asked to insert a new diskette.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.