|
|
|
|
- Error handling
- Operating mode in Windows Vista (and later)
- Creating directories during the copy
fCopyFile (Function) In french: fCopieFichier Copies one or more files (regardless of their attributes).
Syntax
Copying a file or a directory Hide the details
<Result> = fCopyFile(<Source file> , <Destination file or directory> [, <Copy indicator>])
<Result>: Boolean - True if the files have been copied,
- False otherwise. To get more details on the error, use ErrorInfo with the errMessage constant.
<Source file>: Character string File to copy (up to 260 characters). This parameter can be: - a file name. This file will be automatically searched in the current directory (returned by fCurrentDir).
- a file name with its full or relative path. A UNC path can be used.
Special cases according to the platforms: - This parameter can be in Ansi or Unicode format.
Management of wildcard characters (*,?): By default, the wildcard characters are allowed in the name of the file. Special case according to the platform: - If the "*.*" expression is used, only the files that have an extension will be copied.
<Destination file or directory>: Character string Destination file and/or directory (up to 260 characters). This parameter can correspond to:- a file name. This file will be automatically created in the current directory (returned by fCurrentDir).
- a file name with its full or relative path. A UNC path can be used.
- a full or relative path, only for a copy with wildcard characters.
If this parameter corresponds to a directory name, this name may (or may not) end with "\".Special cases according to the platforms: - This parameter can be in Ansi or Unicode format.
<Copy indicator>: Optional constant Type of copy: | | frConfirm | Copy a file and ask for confirmation before overwriting a file with the same name. | frProgress | A progress window is displayed. If the file is small (a few bytes), the progress bar is not displayed. | frRecursive | Recursive copy of the files. The subdirectories and their files are taken into account. |
<Copy indicator> is empty by default. None of these options is selected. Remarks Error handling fCopyFile throws an error in the following cases: - the file to copy does not exist,
- the file to copy is locked,
- is invalid,
- <Path of copied file> is an empty string,
- <Path of file to copy> and <Path of copied file> are identical.
Creating directories during the copy - If one of the directories of the destination path does not exist, it is automatically created.
- If the source file corresponds to all the files found in a directory (for example, C:\Temp\*.*), the frRecursive constant must be used to create the subdirectories in the destination (and to copy their content).
Remark: To copy directories, you also have the ability to use fCopyDir.
Related Examples:
|
Unit examples (WINDEV): Handling text files
[ + ] Handling "text" files with WINDEV: - Create a text file - Write into a text file - Read in a text file
|
|
Unit examples (WEBDEV): Handling text files
[ + ] This example explains how to handle "non HFSQL" files with WEBDEV and it allows you to: - Create a text file - Write into a text file - Read in a text file
|
|
Unit examples (WINDEV Mobile): Handling text files
[ + ] Handling external "text" files: - Create a text file - Write into a text file - Read in a text file
|
Business / UI classification: Business Logic
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|