- Procedure that is using each copied file (syntax 2 only)
- Values returned by the procedure (Syntax 2)
- Managing errors
- Creating directories during the copy
- Equivalence
fCopyFile (Function) In french: fCopieFichier Syntax
Copying a 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 find out the error details, use ErrorInfo associated with the errMessage constant.
<Source file>: Character string (with quotes) File to copy (up to 260 characters). This parameter can correspond to: - a file name. This file will be automatically sought 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:  Versions 15 and later  This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories, as well as onto the external memory (SDCard).  New in version 15 This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories, as well as onto the external memory (SDCard).
Reminder: In Android, the file system is read-only on the device and on the emulator. An application has the rights to write into its setup directory or into one of its subdirectories, as well as onto the external memory (SDCard). Versions 17 and later This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories. New in version 17 This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories. This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories.
Versions 17 and later Windows Phone: This parameter corresponds to a relative path in relation to the current directory. The current directory corresponds to the data directory of application.
Reminder: Only the files found in the data directory associated with the application can be handled. New in version 17 Windows Phone: This parameter corresponds to a relative path in relation to the current directory. The current directory corresponds to the data directory of application.
Reminder: Only the files found in the data directory associated with the application can be handled. Windows Phone: This parameter corresponds to a relative path in relation to the current directory. The current directory corresponds to the data directory of application.
Reminder: Only the files found in the data directory associated with the application can be handled.
Management of wildcard characters (*,?): By default, the wildcard characters are allowed in the name of the file.
Special case according to the platforms: Versions 18 and later The wildcard characters (*,?) are not allowed in the file name. New in version 18 The wildcard characters (*,?) are not allowed in the file name. The wildcard characters (*,?) are not allowed in the file name.  The wildcard characters (*,?) are not allowed.
<Destination file or directory>: Character string (with quotes) 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: Versions 15 and later This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories, as well as onto the external memory (SDCard). New in version 15 This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories, as well as onto the external memory (SDCard). This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories, as well as onto the external memory (SDCard). - This parameter can correspond to:
- a file name with its path.
- a path, only for a copy with wildcard characters. If this parameter corresponds to a directory name, this name may (or may not) end with "\".
Versions 17 and later This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories. New in version 17 This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories. This parameter can correspond to a full path or to a relative path in relation 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 has the rights to write into its setup directory or into one of its subdirectories.
Versions 17 and later This parameter corresponds to a relative path in relation to the current directory. The current directory corresponds to the data directory of application.
Reminder: Only the files found in the data directory associated with the application can be handled. New in version 17 This parameter corresponds to a relative path in relation to the current directory. The current directory corresponds to the data directory of application.
Reminder: Only the files found in the data directory associated with the application can be handled. This parameter corresponds to a relative path in relation to the current directory. The current directory corresponds to the data directory of application.
Reminder: Only the files found in the data directory associated with the application can be handled.
<Copy indicator>: Optional constant Type of copy to perform: | | | 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 sub-directories and their files are taken into account. |
<Copy indicator> is empty by default. None of these options is selected. Versions 19 and later New in version 19 Remarks Versions 19 and laterProcedure that is using each copied file (syntax 2 only) For each file found, fCopyFile automatically calls the <Procedure name> procedure. This procedure is a local or global procedure. To create this procedure: - Create a global procedure (from the code editor: on the "Code" pane, in the "Procedures" group, expand "New" and select "New global procedure").
- Fill the procedure declaration as follows:
PROCEDURE <Procedure name> (<Path of file to copy>, <Path of destination file>, [ <Change>, [<Procedure pointer>]])
- <Path of file to copy> is the path of the file to copy.
- <Path of destination file> is a character string containing the name of the destination file.
- <Change> is an optional constant that is set to:
- flFirstFile when the file is the first file copied into the <Source file> directory.
- flChangeDir when the file is the first file listed in a subdirectory of <Path of directory to copy> (which means that a change of directory occurred).
- flFile in all the other cases.
The different values that can be taken by <Change> are as follows:
| | | Current file | <Change> |
|---|
| Dir\File 1 | flFirstFile | | Dir\File n | flFile | | Dir\SubDir 1\File 1 | flChangeDir | | Dir\SubDir 1\File m | flFile | | Dir\SubDir 2\File 1 | flChangeDir | | Dir\SubDir 2\File x | flFile |
- <Procedure pointer> is an optional integer whose value is the one passed to the <Pointer> parameter of fCopyFile. If <Pointer> is not specified, <Pointer> is set to 0.
To retrieve the value of <Procedure pointer>, its value must be assigned to the value of <Pointer> in the procedure with Transfer. Remark: The parameters of this procedure are optional: you can for example only specify the path of the file to copy and the path of the destination file. New in version 19Procedure that is using each copied file (syntax 2 only) For each file found, fCopyFile automatically calls the <Procedure name> procedure. This procedure is a local or global procedure. To create this procedure: - Create a global procedure (from the code editor: on the "Code" pane, in the "Procedures" group, expand "New" and select "New global procedure").
- Fill the procedure declaration as follows:
PROCEDURE <Procedure name> (<Path of file to copy>, <Path of destination file>, [ <Change>, [<Procedure pointer>]])
- <Path of file to copy> is the path of the file to copy.
- <Path of destination file> is a character string containing the name of the destination file.
- <Change> is an optional constant that is set to:
- flFirstFile when the file is the first file copied into the <Source file> directory.
- flChangeDir when the file is the first file listed in a subdirectory of <Path of directory to copy> (which means that a change of directory occurred).
- flFile in all the other cases.
The different values that can be taken by <Change> are as follows:
| | | Current file | <Change> |
|---|
| Dir\File 1 | flFirstFile | | Dir\File n | flFile | | Dir\SubDir 1\File 1 | flChangeDir | | Dir\SubDir 1\File m | flFile | | Dir\SubDir 2\File 1 | flChangeDir | | Dir\SubDir 2\File x | flFile |
- <Procedure pointer> is an optional integer whose value is the one passed to the <Pointer> parameter of fCopyFile. If <Pointer> is not specified, <Pointer> is set to 0.
To retrieve the value of <Procedure pointer>, its value must be assigned to the value of <Pointer> in the procedure with Transfer. Remark: The parameters of this procedure are optional: you can for example only specify the path of the file to copy and the path of the destination file. Procedure that is using each copied file (syntax 2 only) For each file found, fCopyFile automatically calls the <Procedure name> procedure. This procedure is a local or global procedure. To create this procedure: - Create a global procedure (from the code editor: on the "Code" pane, in the "Procedures" group, expand "New" and select "New global procedure").
- Fill the procedure declaration as follows:
PROCEDURE <Procedure name> (<Path of file to copy>, <Path of destination file>, [ <Change>, [<Procedure pointer>]])
- <Path of file to copy> is the path of the file to copy.
- <Path of destination file> is a character string containing the name of the destination file.
- <Change> is an optional constant that is set to:
- flFirstFile when the file is the first file copied into the <Source file> directory.
- flChangeDir when the file is the first file listed in a subdirectory of <Path of directory to copy> (which means that a change of directory occurred).
- flFile in all the other cases.
The different values that can be taken by <Change> are as follows:
| | | Current file | <Change> |
|---|
| Dir\File 1 | flFirstFile | | Dir\File n | flFile | | Dir\SubDir 1\File 1 | flChangeDir | | Dir\SubDir 1\File m | flFile | | Dir\SubDir 2\File 1 | flChangeDir | | Dir\SubDir 2\File x | flFile |
- <Procedure pointer> is an optional integer whose value is the one passed to the <Pointer> parameter of fCopyFile. If <Pointer> is not specified, <Pointer> is set to 0.
To retrieve the value of <Procedure pointer>, its value must be assigned to the value of <Pointer> in the procedure with Transfer. Remark: The parameters of this procedure are optional: you can for example only specify the path of the file to copy and the path of the destination file. Versions 19 and laterValues returned by the procedure (Syntax 2) The <Procedure name> procedure must return one of the following values: | | | fcStop | Used to stop the copy permanently. | | fcCopy | Used to continue the copy. | | fcIgnore | Used to ignore the copy of a file. |
A WLanguage error occurs if the procedure does not return one of these values. Case 1. Full interruption of copy To force the interruption of copy, the <Procedure name> procedure must return the fcStop constant. Example: the "CopyProduct" procedure is automatically called by fCopyFile:
PROCÉDURE CopyProduct(PathSourceFile, PathDestinationFile)
...
// Stop requested?
Multitask(-1)
IF KeyPressed(kpEscape) = True THEN
Info("The copy will be stopped")
RESULT fcStop
END
...
RESULT fcCopy
If the Esc key is pressed, fCopyFile returns the fcStop constant. In the other cases (to continue the browse), the <Procedure name> procedure returns the fcCopy constant. Case 2. Partial interruption of copy In order for the <Procedure name> procedure not to be run for a given file, the <Procedure name> procedure must return the fcIgnore constant. Example: The "FindProduct" procedure is automatically called by fCopyFile:
PROCÉDURE FindProduct(PathSourceFile, PathDestinationFile)
...
// File to ignore
IF StringEndsWith(PathSourceFile, "WrongFile.XLS") THEN
RESULT fcIgnore
END
...
RESULT fcCopy
To avoid copying the "WrongFile.XLS" file, the procedure returns the fcIgnore constant. The <Procedure name> procedure is automatically called for the next copied file, without copying the current file. New in version 19Values returned by the procedure (Syntax 2) The <Procedure name> procedure must return one of the following values: | | | fcStop | Used to stop the copy permanently. | | fcCopy | Used to continue the copy. | | fcIgnore | Used to ignore the copy of a file. |
A WLanguage error occurs if the procedure does not return one of these values. Case 1. Full interruption of copy To force the interruption of copy, the <Procedure name> procedure must return the fcStop constant. Example: the "CopyProduct" procedure is automatically called by fCopyFile:
PROCÉDURE CopyProduct(PathSourceFile, PathDestinationFile)
...
// Stop requested?
Multitask(-1)
IF KeyPressed(kpEscape) = True THEN
Info("The copy will be stopped")
RESULT fcStop
END
...
RESULT fcCopy
If the Esc key is pressed, fCopyFile returns the fcStop constant. In the other cases (to continue the browse), the <Procedure name> procedure returns the fcCopy constant. Case 2. Partial interruption of copy In order for the <Procedure name> procedure not to be run for a given file, the <Procedure name> procedure must return the fcIgnore constant. Example: The "FindProduct" procedure is automatically called by fCopyFile:
PROCÉDURE FindProduct(PathSourceFile, PathDestinationFile)
...
// File to ignore
IF StringEndsWith(PathSourceFile, "WrongFile.XLS") THEN
RESULT fcIgnore
END
...
RESULT fcCopy
To avoid copying the "WrongFile.XLS" file, the procedure returns the fcIgnore constant. The <Procedure name> procedure is automatically called for the next copied file, without copying the current file. Values returned by the procedure (Syntax 2) The <Procedure name> procedure must return one of the following values: | | | fcStop | Used to stop the copy permanently. | | fcCopy | Used to continue the copy. | | fcIgnore | Used to ignore the copy of a file. |
A WLanguage error occurs if the procedure does not return one of these values. Case 1. Full interruption of copy To force the interruption of copy, the <Procedure name> procedure must return the fcStop constant. Example: the "CopyProduct" procedure is automatically called by fCopyFile:
PROCÉDURE CopyProduct(PathSourceFile, PathDestinationFile)
...
// Stop requested?
Multitask(-1)
IF KeyPressed(kpEscape) = True THEN
Info("The copy will be stopped")
RESULT fcStop
END
...
RESULT fcCopy
If the Esc key is pressed, fCopyFile returns the fcStop constant. In the other cases (to continue the browse), the <Procedure name> procedure returns the fcCopy constant. Case 2. Partial interruption of copy In order for the <Procedure name> procedure not to be run for a given file, the <Procedure name> procedure must return the fcIgnore constant. Example: The "FindProduct" procedure is automatically called by fCopyFile:
PROCÉDURE FindProduct(PathSourceFile, PathDestinationFile)
...
// File to ignore
IF StringEndsWith(PathSourceFile, "WrongFile.XLS") THEN
RESULT fcIgnore
END
...
RESULT fcCopy
To avoid copying the "WrongFile.XLS" file, the procedure returns the fcIgnore constant. The <Procedure name> procedure is automatically called for the next copied file, without copying the current file. Managing errors fCopyFile generates 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 sub-directories 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
|
This page is also available for…
|
|
|
| |
| | https://youtu.be/qws0RUJ0Eqs
http://windevdesenvolvimento.blogspot.com.br/2018/05/dicas-1745-privada-windev-arquivos-29.html
https://groups.google.com/d/forum/amarildowindev
// EXEMPLO
// COPIAR ARQUIVO
// http://doc.windev.com/en-US/?3036004&name=fcopyfile_function
Resultado is boolean = fCopyFile("C:\amarildo\ipi.txt", EDT_DIRETORIO+"ipi.txt")
|
|
|
|
| |
| |
| |
|
| | Copiar Arquivo
Nessa aula vou mostrar como copiar um arquivo
This lesson will show you how to copy a file
Cette leçon va vous montrer comment copier un fichier
n_resultado is int=fCopyFile("D:\amarildo\Copia\copiaarquivo.txt","D:\amarildo\Copia\novoarquivo.txt")
n_resultado_F est entier=fCopieFichier("D:\amarildo\Copia\copiaarquivo.txt","D:\amarildo\Copia\novoarquivo.txt")
//Blog com Video e exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/08/curso-windev-arquivos-008-arquivos.html
https://www.youtube.com/watch?v=Q05zcTyXV1c
|
|
|
|
| |
| |
| |
| |
| |
| |
| | |
|