Functions > FileDirDisk >

FileWriteLine

Ajoute une ligne de texte � la fin d'un fichier texte pr�c�demment ouvert.

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

Param�tres

filehandle/filename Le handle d'un fichier, retourn� par la fonction FileOpen(). Alternativement, le nom complet 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�.

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0 si le fichier n'est pas ouvert en mode �criture, si le fichier est en lecture seule, ou si le fichier ne peut remplacer un fichier existant.

Remarques

Le fichier texte doit �tre ouvert en mode �criture ou la fonction FileWriteLine() �chouera.

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 de gros 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 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. Utiliser soit les chemins d'acc�s, soit les handles dans vos fonctions, mais pas les deux.

Lors de l'�criture d'un texte, 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) sinon l'�criture sera tronqu�e. Si FileWrite() est utilis�e sur un fichier ouvert en mode binaire, elle doit �tre utilis� pour �crire des caract�res.

En relation

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

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 pour �crire des donn�es.
    If Not FileWrite($sFilePath, "D�marre l'exemple FileWriteLine, ligne 1. " & @CRLF) Then
        MsgBox($MB_SYSTEMMODAL, "", "Une erreur est survenue lors de l'�criture du fichier temporaire.")
        Return False
    EndIf

    ; Ouvre le fichier en �criture (ajoute � la fin du fichier) et stocke le handle dans une variable.
    Local $hFileOpen = FileOpen($sFilePath, $FO_APPEND)
    If $hFileOpen = -1 Then
        MsgBox($MB_SYSTEMMODAL, "", "Une erreur est survenue lors de la lecture du fichier.")
        Return False
    EndIf

    ; �crit des donn�es dans le fichier � l'aide du handle retourn�e par FileOpen.
    FileWriteLine($hFileOpen, "Ligne 2")
    FileWriteLine($hFileOpen, "Ceci est la ligne 3, nouvelle ligne ajout�e au dernier appel de FileWriteLine." & @CRLF)
    FileWriteLine($hFileOpen, "Line 4" & @CRLF)
    FileWriteLine($hFileOpen, "Line 5")

    ; Ferme le handle retourn� par FileOpen.
    FileClose($hFileOpen)

    ; Affiche le contenu du fichier en passant le chemin du fichier � FileRead au lieu du handle retourn� par FileOpen.
    MsgBox($MB_SYSTEMMODAL, "", "Contenu du fichier:" & @CRLF & FileRead($sFilePath))

    ; Supprime le fichier temporaire.
    FileDelete($sFilePath)
EndFunc   ;==>Example