Functions > FileDirDisk >

FileSetPos

D�finit la position courante du pointeur d'un fichier.

FileSetPos ( "filehandle", offset, origin )

Param�tres

filehandle Le handle du fichier pr�c�demment ouvert avec FileOpen().
offset Le d�placement par rapport � l'origine d�finie dans le param�tre suivant. Cette valeur peut �tre positive ou n�gative. Les valeurs n�gatives d�placent le pointeur vers l'arri�re par rapport � l'origine.
origin Doit �tre l'une des valeurs suivantes:
    $FILE_BEGIN (0) - D�but du fichier.
    $FILE_CURRENT (1) - Position actuelle.
    $FILE_END (2) - Fin de fichier.

Les constantes sont d�finies dans FileConstants.au3

Valeur de retour

Succ�s: Retourne True si l'op�ration a r�ussi.
�chec: Retourne False.

Remarques

En utilisant FileSetPos() il est possible de lire et �crire sur le m�me fichier. Lorsque vous tentez de lire et d'�crire sur le m�me fichier, utiliser toujours FileFlush() entre chaque op�ration de lecture et d'�criture.

D�placer le pointeur au milieu des donn�es peut �tre utilis� pour �craser des donn�es.

En relation

FileFlush, FileGetPos, FileOpen, FileRead, FileReadLine, FileWrite, FileWriteLine

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)

    ; 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 en lisant le fichier.")
        Return False
    EndIf

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

    ; Vide le buffer du fichier sur le disque.
    FileFlush($hFileOpen)

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

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

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

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

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