|
|
|
|
- Error handling
- 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 correspond to a full path or a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder: In Android, the file system is read-only on the device and on the emulator. An application can only write to its installation directory or one of its subdirectories, as well as to the external memory (SDCard). - This parameter can correspond to a full path or a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder: On iPhone/iPad, the file system is read-only on the device and on the emulator. An application can only write to its installation directory or one of its subdirectories.
Management of wildcard characters (*,?): By default, the wildcard characters are allowed in the name of the file. Special case according to the platform: <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 correspond to a full path or a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder: In Android, the file system is read-only on the device and on the emulator. An application can only write to its installation directory or one of its subdirectories, as well as to the external memory (SDCard). - This parameter can correspond to a full path or a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder: On iPhone/iPad, the file system is read-only on the device and on the emulator. An application can only write to its installation directory or one of its subdirectories.
<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.
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…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|