Aide:FileWrite.txt

Document original V3.3.6.1 :

###Function###
FileWrite

###Description###
Append a text/data to the end of a previously opened file.

###Syntax###
FileWrite ( "filehandle/filename", "text/data" )


###Parameters###
@@ParamTable@@
filehandle/filename
	The handle of a file, as returned by a previous call to FileOpen.  Alternatively, you may use a string filename as the first parameter.
text/data
	The text/data to write to the file. The text is written as is - no @CR or @LF characters are added. See remark for data type.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns 1.
Failure:	Returns 0 if file not opened in writemode, file is read only, or file cannot otherwise be written to.
@@End@@


###Remarks###
The file must be opened in write mode or the FileWrite command will fail.

If a filename is given rather than a file handle, the file will be opened and closed during the function call.  For parsing large text files this will be much slower than using filehandles.  However, filename will be created if it does not already exist.

Note: Do not mix filehandles and filenames, i.e., don't FileOpen a file and then use a filename in this function. Either use filehandles or filenames in your routines, not both.

When writing text AutoIt will write using ANSI by default. To write in Unicode mode the file must be opened with FileOpen() and the relevant flags.

If the data is a binary type variant (and not text) it will be written to the file byte by byte. Binary operation can also be forced by using Fileopen with the binary flag.


###Related###
FileFlush, FileOpen, FileRead, FileReadLine, FileWriteLine, Binary, FileSetPos, FileGetPos


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

Document traduit V3.3.6.1 :

###Function###
FileWrite

###Description###
Ajoute un texte/des données à la fin d'un fichier précédemment ouvert.


###Syntax###
FileWrite ( "filehandle/filename", "text/data" )


###Parameters###
@@ParamTable@@
filehandle/filename
	Le handle d'un fichier renvoyé précédemment par FileOpen. Alternativement, vous pouvez utiliser le nom et le chemin du fichier comme premier paramètre.
text/data
	Le texte/les données à écrire dans le fichier. Le texte est écrit tel quel - aucuns @CR ou @LF ne sont ajoutés. Voir les remarques pour le type de données.
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès:	Retourne 1.
Échec:	Retourne 0 si le fichier n'est pas ouvert en écriture, si le fichier est en lecture seule, ou si le fichier ne peut être écrit autrement.
@@End@@


###Remarks###
Le fichier doit être ouvert en écriture, sinon la commande FileWrite échouera.

Si un nom de fichier est donné plutôt qu'un handle de fichier, celui-ci sera ouvert puis fermé durant l'appel de la fonction. Pour un traitement sur de grands fichiers texte ceci sera beaucoup plus lent que d'utiliser un handle de fichier. Ceci dit, le fichier sera créé s'il n'existe pas déjà.

Note: Ne mélangez pas les handles de fichier et les noms de fichiers, par exemple, n'utilisez pas FileOpen pour ensuite utiliser le nom du fichier dans cette fonction. Utilisez les handles ou les noms de fichiers dans votre routine, mais pas les deux.

Lors de l'écriture d'un texte, AutoIt utilise la norme ANSI par défaut. Pour écrire en mode Unicode, le fichier doit être ouvert avec FileOpen() et les paramètres appropriés.

Si les données sont une variante de type binaire (et non du texte), il sera écrit dans le fichier octet par octet. Une opération binaire peut aussi être forcée en utilisant FileOpen avec le paramètre binaire.


###Related###
<a href="FileFlush.htm">FileFlush</a>, <a href="FileOpen.htm">FileOpen</a>, <a href="FileRead.htm">ProcessSetPriority</a>, <a href="ProcessWait.htm">FileRead</a>, <a href="FileReadLine.htm">FileReadLine</a>, <a href="FileWriteLine.htm">FileWriteLine</a>, <a href="Binary.htm">Binary</a>, <a href="FileSetPos.htm">FileSetPos</a>, <a href="FileGetPos.htm">FileGetPos</a>


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

Traducteur : TT22