COPYFILE

Purpose:

Copies one or more files to a destination file or directory.

Syntax:

COPYFILE("srcname", "desname", overwrite)

"srcname"

A string, the name of the file or directory to copy. The name can include * or ? wildcard characters.

"desname"

A string, the name of the destination file or directory.

overwrite

Optional, an integer confirm delete flag.

0:	Overwrite without confirmation (default).
1:	Confirm overwrite
2:	Do not overwrite.

Returns:

An integer, the count of the number of files successfully copied.

Example:

copyfile("myfun.spl", "myfun.spl.bak")

copies the file myfun.spl to myfun.spl.bak in the current directory. If myfile.spl.bak is overwritten if it already exists.

Example:

copyfile("\spldir\*.spl", "E:\splbackup")

copies all files with extension .spl in the directory \spldir to the directory E:\splbackup. The number of files copied is returned.

Example:

copyfile("\spldir", "E:\splbackup")

copies all files and sub-directories in the directory \spldir to the directory E:\splbackup. The number of files copied is returned.

Remarks:

COPYFILE copies a source file to a destination file or directory. If the source is a directory or resolves to multiple files, the target must also be a directory.

If the source name specifies a directory, all of the files and sub-directories are copied to the target directory.

The source name may contain the * and ? characters to specify multiple files.

See MOVEFILE to move one or more source files or a directory to a new destination and delete the original files.

COPYFILE

Purpose:

Syntax:

Returns:

Example:

Example:

Example:

Remarks:

See Also: