Procedure FileCopy(source, destination[, confirm])

FileCopy

The procedure FileCopy copies one or more files to a new name or to another directory.

FileCopy(
        source,      ! (input) scalar string expression
        destination, ! (input) scalar string expression
        [confirm]    ! (optional) 0 or 1
        )

Arguments

source

A scalar string expression representing the file(s) you want to copy. The string may contain wild-card characters such as ‘*’ and ‘?’, allowing you to copy a whole group of files at once.

destination

A scalar string expression representing the destination file name or destination directory.

confirm (optional)

An integer value that indicates whether or not you want to let the user confirm any copy operation that would overwrite existing files. If this argument is omitted, then the default behavior is that files are overwritten without any notice.

Return Value

The procedure returns 1 on success. If it fails, then it returns 0, and the pre-defined identifier CurrentErrorMessage will contain a proper error message.

See also

The procedures FileMove, DirectoryCopy, FileExists.