Functions > FileDirDisk >

FileCopy

Copie un ou plusieurs fichiers.

FileCopy ( "source", "dest" [, flag = 0] )

Param�tres

source Chemin du r�pertoire contenant le(s) fichier(s) � copier. (Les caract�res g�n�riques (Wildcards) * et ? sont pris en charge - Voir Remarques)
dest Chemin du r�pertoire de destination du/des fichier(s) � copier.
flag [optionnel] Ce param�tre d�termine s'il faut �craser les fichiers existants.
Est une combinaison des �l�ments suivants:
    $FC_NOOVERWRITE (0) = (par d�faut) n'�crase pas les fichiers existants
    $FC_OVERWRITE (1) = �crase les fichiers existants
    $FC_CREATEPATH (8) = Cr�e la structure du r�pertoire de destination, si elle n'existe pas (Voir Remarques).

Les constantes sont d�finies dans FileConstants.au3

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0.

Remarques

Consultez FileFindFirstFile pour des pr�cisions sur les wildcards.

Le r�pertoire de destination doit exister, sauf si le param�tre $FC_CREATEPATH(8) est utilis�.
Par exemple le param�tre combin� $FC_OVERWRITE (1) + $FC_CREATEPATH (8), �crase le fichier cible et v�rifie la structure du r�pertoire de destination pour la cr�er automatiquement si elle n'existe pas.

Certains attributs de fichier peuvent rendre l'�crasement impossible, si c'est le cas consultez FileSetAttrib() pour changer les attributs d'un fichier.

En relation

DirCopy, DirCreate, FileDelete, FileMove

Exemple

#include <FileConstants.au3>
#include <MsgBoxConstants.au3>
#include <WinAPIFiles.au3>

Example()

Func Example()
    ; Cr�e une constante locale avec le chemin du fichier qui sera lu/�crit.
    Local Const $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; Cr�e un fichier temporaire � copier.
    If Not FileWrite($sFilePath, "Exemple d'utilisation de FileCopy.") Then
        MsgBox($MB_SYSTEMMODAL, "", "Une erreur est survenue lors de l'�criture du fichier temporaire.")
        Return False
    EndIf

    ; Copie les fichiers Au3 dans le r�pertoire temporaire vers un nouveau r�pertoire appel� Au3Files.
    FileCopy(@TempDir & "\*.au3", @TempDir & "\Au3Files\", $FC_OVERWRITE + $FC_CREATEPATH)

    ; Affiche le r�pertoire temporaire.
    ShellExecute(@TempDir)
EndFunc   ;==>Example