Functions > FileDirDisk >


FileGetPos

Obtient la position courante du pointeur d'un fichier.

FileGetPos ( "filehandle" )

Paramètre

filehandle Le handle d'un fichier précédemment ouvert avec FileOpen().

Valeur de retour

Succès: Retourne la position courante du pointeur du fichier par rapport au début du fichier (le premier index est 0).
Échec: Retourne 0 et définit @error <> 0.

Remarque

Un échec retourne 0, mais 0 est également une position valide dans le fichier, alors vérifiez @error pour déterminer la condition d'erreur.

En relation

FileOpen, FileRead, FileReadLine, FileSetPos, 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 lors de l'écriture dans 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