Functions > FileDirDisk >

FileMove

D�place un ou plusieurs fichiers.

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

Param�tres

source Chemin et noms des fichiers sources � d�placer. (Les Wildcards sont pris en charge - Voir Remarques)
dest Chemin et noms des fichiers � d�placer. (Les Wildcards sont pris en charge - Voir Remarques)
flag [optionnel] D�termine s'il faut �craser les fichiers existants.
Doit �tre 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 si source ne peut pas �tre d�plac�e ou si dest existe d�j� et flag=0.

Remarques

Consultez FileFindFirstFile() pour des pr�cisions sur les wildcards (caract�res sp�ciaux).

Si les chemins d'acc�s de la source et de la destination sont sur des volumes diff�rents une copie puis une suppression est effectu�e au lieu d'un d�placement.

Parce que AutoIt ne poss�de pas de fonction "FileRename", utiliser FileMove() pour renommer un fichier!

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, et si elle n'existe pas, il la cr�e automatiquement.

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

DirMove, FileCopy, FileDelete, FileRecycle

Exemples

Exemple 1

#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 qui sera d�plac�.
    If Not FileWrite($sFilePath, "Exemple d'utilisation de FileMove.") Then
        MsgBox($MB_SYSTEMMODAL, "", "Une erreur est survenue lors de l'�criture dans le fichier temporaire.")
        Return False
    EndIf

    ; D�place les fichiers Au3 du r�pertoire temporaire vers un nouveau dossier/r�pertoire appel� Au3Files.
    FileMove(@TempDir & "\*.au3", @TempDir & "\Au3Files\", $FC_OVERWRITE + $FC_CREATEPATH)

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

Exemple 2

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

Example()

Func Example()
    ; Cr�e une constante locale avec des chemins de fichiers qui seront renomm�s.
    Local Const $sSource = _WinAPI_GetTempFileName(@TempDir), _
            $sDestination = _WinAPI_GetTempFileName(@TempDir)"

    ; Cr�e un fichier temporaire qui sera renomm�.
    If Not FileCreate($sSource, "Exemple d'utilisation de FileMove.") Then
        MsgBox($MB_SYSTEMMODAL, "", "Une erreur est survenue lors de l'�criture dans le fichier temporaire.")
        Return False
    EndIf

    ; Renomme un fichier en utilisant FileMove et remplace le nouveau fichier s'il existe.
    FileMove($sSource, $sDestination, $FC_OVERWRITE)

    ; Affiche les r�sultats pour montrer que le fichier de destination a �t� renomm�.
    MsgBox($MB_SYSTEMMODAL, "", "FileMove.txt existe-t-il ?: " & FileExists($sSource) & @CRLF & _ ; FileExists doit retourner 0.
            "FileMove_New.txt existe-t-il ?: " & FileExists($sDestination) & @CRLF) ;FileExists doit retourner 1.

    ; Supprime les fichiers temporaires. FileDelete v�rifie si le fichier existe.
    FileDelete($sSource)
    FileDelete($sDestination)
EndFunc   ;==>Example