Functions > FileDirDisk >


FileFlush

Vide la m�moire tampon d'un fichier sur le disque.

FileFlush ( "filehandle" )

Param�tre

filehandle Le handle du fichier pr�c�demment ouvert avec FileOpen().

Valeur de retour

Succ�s: Retourne True si la m�moire tampon (buffer) a �t� vid�e (ou n'a pas besoin d'�tre vid�e).
Echec: Retourne False.

Remarque

Le buffer d'un fichier est vid� lorsque son handle est ferm� ou lorsque le buffer interne de Windows est plein. Cette fonction force un vidage imm�diat du buffer.
Cette fonction ne peut �tre utilis�e qu'avec les handles de fichiers retourn�s par FileOpen().

En relation

FileClose, FileOpen, FileSetPos, FileWrite, FileWriteLine

Exemple

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

Example()

Func Example()
    ; Cr�e une constante locale du nom complet du fichier qui sera lu/�crit.
    Local Const $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; Ouvre le fichier en �criture (�crase un fichier existant) et stocke le handle dans une variable.
    Local $hFileOpen = FileOpen($sFilePath, $FO_OVERWRITE)
    If $hFileOpen = -1 Then
        MsgBox($MB_SYSTEMMODAL, "", "Une erreur est survenue lors de l'�criture dans le fichier.")
        Return False
    EndIf

    ; �crit des donn�es dans le fichier � l'aide du handle retourn� par FileOpen.
    FileWriteLine($hFileOpen, "Line 1")
    FileWriteLine($hFileOpen, "Line 2")
    FileWriteLine($hFileOpen, "Line 3")

    ; Vide le tampon du fichier.
    FileFlush($hFileOpen)

    ; V�rifie la position dans le fichier et essaie de lire le contenu � la position courante.
    MsgBox($MB_SYSTEMMODAL, "", "Position: " & FileGetPos($hFileOpen) & @CRLF & "Data: " & @CRLF & FileRead($hFileOpen))

    ; Maintenant, ajuste la position sur le d�but.
    FileSetPos($hFileOpen, 0, $FILE_BEGIN)

    ; V�rifie la position de fichier et essaie de lire le contenu � la position actuelle.
    MsgBox($MB_SYSTEMMODAL, "", "Position: " & FileGetPos($hFileOpen) & @CRLF & "Data: " & @CRLF & FileRead($hFileOpen))

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

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