Aide:FileWriteLine.txt

Document original V3.3.6.1 :

###Function###
FileWriteLine

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

###Syntax###
FileWriteLine ( "filehandle/filename", "line" )


###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.
line
	The line of text to write to the text file.  If the line does NOT end in @CR or @LF then a DOS linefeed (@CRLF) will be automatically added.
@@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 text file must be opened in write mode or the FileWriteLine 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.

The text to write cannot contain Chr(0) characters as the output is truncated. FileWrite() using a file opened in binary mode must be used to write such characters.


###Related###
FileFlush, FileOpen, FileRead, FileReadLine, FileWrite, FileSetPos, FileGetPos


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

Document traduit V3.3.6.1 :

###Function###
FileWriteLine

###Description###
Ajoute une ligne de texte à la fin d'un fichier texte précédemment ouvert.

###Syntax###
FileWriteLine ( "filehandle/filename", "line" )


###Parameters###
@@ParamTable@@
filehandle/filename
	Le handle d'un fichier, renvoyé par l'utilisation de la commande FileOpen. Alternativement, vous pouvez utiliser une chaine de caractères contenant le chemin d'accès du fichier comme premier paramètre.
line
	La ligne de texte à écrire dans le fichier. Si la ligne ne se termine pas par @CR ou @LF, un saut de ligne DOS (@CRLF) sera automatiquement ajouté.
@@End@@

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


###Remarks###
Le fichier texte doit être ouvert en writemode ou la commande FileWriteLine va échouer.

Si un chemin d'accès est donné plutôt qu'un handle, le fichier sera ouvert et fermé durant l'appel de fonction. Pour l'analyse de grands fichiers texte ce sera beaucoup plus lent que d'utiliser un handle. Cependant, le fichier sera créé s'il n'existe pas déjà.

Note: Ne pas mélanger handles et des chemins d'accès, c'est à dire, ne pas utiliser FileOpen pour un fichier et ensuite utiliser un chemin d'accès dans cette fonction. Soit utiliser les chemins d'accès les handles dans votre routine, mais pas les deux.

Lors de l'écriture d'un teste, AutoIt écrit en utilisant la norme ANSI par défaut. Pour écrire en mode Unicode le fichier doit être ouvert avec FileOpen() et les flags correspondants.

Le texte à écrire ne peut pas contenir Chr(0) comme la sortie est tronquée. FileWrite() utilisant un fichier ouvert en mode binaire doit être utilisé pour écrire ces caractères.

###Related###
FileFlush, FileOpen, FileRead, FileReadLine, FileWrite, FileSetPos, FileGetPos


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

Traducteur : TT22