FileCopy Function

Format

i = filecopy(file_name, output_file_name);

Description

The filecopy function copies one file to another file or copies a group of files to a folder. The file_name is a string expression or string List giving the source file name(s). The output_file_name is a string expression giving the destination file or folder name. The arguments can also be file handlers declared in File statements.

You can use the wildcard characters "*" and "?" to specify a group of files to copy as the file_name. If using wildcard characters, the output_file_name must be the name of a folder.

Files can also be copied using the File.copy action.

Return Value

The function returns the number of files copied. If there was an error copying files, the function returns default.

Example 1

filecopy("Virginia.csdb", "Virginia_Backup.csdb");

Example 2

string backup_folder_name = pathconcat(Application, maketext("Backup%d", timestamp()));
dircreate(backup_folder_name);

filecopy(pathconcat(Application, "*.csdb"), backup_folder_name);