Aide:FileInstall.txt

Document original V3.3.6.1 :

###Function###
FileInstall

###Description###
Include and install a file with the compiled script.

###Syntax###
FileInstall ( "source", "dest" [, flag] )


###Parameters###
@@ParamTable@@
source
	The source path of the file to compile.  <b>This must be a literal string; it cannot be a variable or the result of a function call.</b>  It can be a relative path (using .\ or ..\ in the path) to the source file (.au3).
dest
	The destination path of the file with trailing backslash if only the directory is used.  This can be a variable.
flag
	[optional] this flag determines whether to overwrite files if they already exist:
	  0 = (default) do not overwrite existing files
	  1 = overwrite existing files
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns 1.
Failure:	Returns 0.
@@End@@


###Remarks###
The FileInstall function is designed to include files into a compiled AutoIt script.  These included files can then be "extracted" during execution of the compiled script if the statement is executed.  Keep in mind that files such as images can greatly increase the size of a compiled script.
The source file must be specified using a string literal and can <b>not</b> be a variable, a calculation nor function call.  The file must be able to be found during compiling, however variables, calculations and function calls do not get resolved until the script itself is running, long after compiling, making them unsuitable to define the source file.
The source cannot contain wildcards.

When this function is used from a non-compiled script, a copy operation is performed instead (to allow for easy testing pre-compilation).
Files maintain their original creation/modification timestamps when installed.

The destination directory path must already exist before this function is called, or the FileInstall will fail, returning 0 and not creating the file, nor path.  See DirCreate() for information about creating the directory path.

The file attributes on an existing file may prevent the file from being overwritten.  Use FileDelete() or FileSetAttrib() to ensure the file can be installed without issue.

###Related###
DirCreate, FileDelete, FileSetAttrib

###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
FileInstall

###Description###
Inclut et installe un fichier avec le script compilé.


###Syntax###
FileInstall ( "source", "dest" [, flag] )


###Parameters###
@@ParamTable@@
source
	Le chemin source du fichier à compiler.  <b>Ceci doit être une chaîne littérale et ne peut pas être une variable ou le résultat d'un appel de fonction.</b>  Cela peut être un chemin relatif (utilisant .\ ou ..\ dans le chemin) du fichier source (.au3).
dest
	Le chemin de destination du fichier terminé par un antislash si le répertoire seul est utilisé. Ceci peut être une variable.
flag
	[optionnel] ce paramètre détermine s'il faut écraser les fichiers existants :
	  0 = (défaut) n'écrase pas les fichiers existants
	  1 = écrase les fichiers existants
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès:	Retourne 1.
Échec:	Retourne 0.
@@End@@


###Remarks###
La fonction FileInstall est conçue pour inclure des fichiers dans un script AutoIt compilé. Ces fichiers peuvent ensuite être "extrait" au cours de l'exécution du script compilé si l'instruction est exécutée. Gardez à l'esprit que des fichiers tel que des images peuvent considérablement augmenter la taille d'un script compilé.
Le fichier source doit être spécifié en utilisant une chaîne littérale et ne peut <b>pas</b> être une variable, un calcul, ou un appel de fonction. Le fichier doit pouvoir être trouvé lors de la compilation, alors que variables, calculs et appels de fonction ne seront pas résolus tant que le script lui-même ne sera pas lancé, longtemps après la compilation, les rendant inutilisable pour définir le fichier source.
La source ne peut pas contenir des wildcards.

Lorsque cette fonction est utilisée à partir d'un script non compilé, une opération de copie est exécutée (afin de faciliter les tests de pré-compilation).
Les Fichiers conservent leur date de création/modification originales lorsqu'ils sont installés.

Le chemin du répertoire de destination doit déjà exister avant d'appeler de cette fonction, ou le FileInstall échouera, en retournant 0 et sans créer le fichier, ni le chemin. Voir DirCreate() pour plus d'informations sur la création du chemin de répertoire.

Les attributs d'un fichier existant peuvent empêcher l'écrasement de celui-ci. Utilisez FileDelete() ou FileSetAttrib() pour vous assurer que le fichier peut être installé sans problème.


###Related###
<a href="DirCreate.htm">DirCreate</a>, <a href="FileDelete.htm">FileDelete</a>, <a href="FileSetAttrib.htm">FileSetAttrib</a>


###Example###
@@IncludeExample@@

Traducteur :TT22