UDF > File >

_FileWriteToLine

�crit du texte sur une ligne donn�e d'un fichier

#include <File.au3>
_FileWriteToLine ( $sFilePath, $iLine, $sText [, $bOverWrite = False [, $bFill = False]] )

Param�tres

$sFilePath Le fichier dans lequel �crire
$iLine Le num�ro de la ligne dans laquelle �crire le texte
$sText Le texte � �crire
$bOverwrite [optionnel]
    True - Le texte remplacera l'ancien
    False - (par d�faut) Le texte sera ins�r� � la ligne donn�e et toutes les lignes suivantes seront d�cal�es vers le bas
$bFill [optionnel]
    True - ajoutera des lignes vides au fichier si n�cessaire afin que le num�ro de ligne existe.
    False - (par d�faut) n'ajoutera pas de lignes. Voir Remarque ci-dessous

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0 et d�finit @error <> 0.
@error: 1 - Le fichier a moins de lignes que $iLine
2 - Le fichier n'existe pas
3 - Erreur lors de l'ouverture du fichier
4 - $iLine est invalide
5 - $fOverwrite est invalide
6 - $sText est invalide
7 - $bFill est invalide

Remarque

Si _FileWriteToLine() est appel�e avec $bOverwrite = True et $sText = "", la fonction supprimera la ligne.

Par d�faut, la fonction retournera une erreur si la ligne n'existe pas dans le fichier, mais si le param�tre $bFill est d�fini � True, cela forcera l'ajout de lignes vides pour remplir le fichier � une taille permettant l'�criture de la ligne.

Exemple

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

Example()

Func Example()
    ; Cr�e une constante de port�e Local avec le chemin du fichier qui sera lu/�crit.
    Local Const $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; Cr�e des donn�es � �crire dans le fichier.
    Local $sData = "Ligne 1: Ceci est un exemple d'utilisation de _FileWriteToLine()" & @CRLF & _
            "Ligne 2: Ceci est un exemple d'utilisation de _FileWriteToLine()" & @CRLF & _
            "Ligne 3: Ceci est un exemple d'utilisation de _FileWriteToLine()" & @CRLF & _
            "Ligne 4: Ceci est un exemple d'utilisation de _FileWriteToLine()" & @CRLF & _
            "Ligne 5: Ceci est un exemple d'utilisation de _FileWriteToLine()" & @CRLF

    ; Cr�e un fichier temporaire pour lire dedans.
    If Not FileWrite($sFilePath, $sData) Then
        MsgBox($MB_SYSTEMMODAL, "", "Erreur lors de l'�criture dans le fichier temporaire.")
        Return False
    EndIf

    ; Ecrit en ligne 3 avec remplacement d�fini � true.
    _FileWriteToLine($sFilePath, 3, "Ligne 3: CECI A �T� REMPLAC�", True)

    ; Lit le contenu du fichier en utilisant filepath.
    Local $sFileRead = FileRead($sFilePath)

    ; Affiche le contenu du fichier
    MsgBox($MB_SYSTEMMODAL, "", "Contenu du fichier:" & @CRLF & $sFileRead)

    ; Ecrit en ligne 3 avec remplacement d�fini � false.
    _FileWriteToLine($sFilePath, 3, "Ligne 3: CECI A �T� INS�R�", False)

    ; Lit le contenu du fichier en utilisant filepath.
    $sFileRead = FileRead($sFilePath)

    ; Affiche le contenu du fichier.
    MsgBox($MB_SYSTEMMODAL, "", "Contenu du fichier:" & @CRLF & $sFileRead)

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