OpenFile()

Syntaxe

Resultat = OpenFile(#Fichier, NomFichier$ [, Options])
Description
Ouvre un fichier en lecture et en écriture ou le crée s'il n'existe pas.

Arguments

#Fichier Le fichier à utiliser.

#PB_Any peut être utilisé pour générer automatiquement ce numéro.
NomFichier$ Le nom du fichier à ouvrir.
Options (optionnel) Peut être une combinaison de:
  #PB_File_SharedRead : Le fichier ouvert peut être lu par un autre processus (Windows uniquement).
  #PB_File_SharedWrite: Le fichier ouvert peut être écrit par un autre processus (Windows uniquement).
  #PB_File_Append     : La position du pointeur de fichier sera fixée à la fin du fichier.
  #PB_File_NoBuffering: Le système interne de mise en mémoire tampon de PureBasic sera désactivé pour ce fichier. 
                        FileBuffersSize() ne peut pas être utilisé sur ce fichier.
combiné avec l'une des valeurs suivantes (les options suivantes affectent le comportement de WriteString(), WriteStringN(), ReadString(), ReadCharacter() et WriteCharacter()):
  #PB_Ascii  : Toute opération de lecture/écriture des chaînes de caractères utilisera le mode ASCII
               (Par défaut pour les exécutables compilés en mode ASCII).
  #PB_UTF8   : Toute opération de lecture/écriture des chaînes de caractères utilisera le mode UTF-8
               (Par défaut pour les exécutables compilés en mode Unicode).
  #PB_Unicode: Toute opération de lecture/écriture des chaînes de caractères utilisera le mode Unicode.

Valeur de retour

Renvoie une valeur non nulle en cas de succès zéro sinon.

Si #PB_Any est utilisé pour le paramètre '#Fichier', le numéro du nouveau fichier sera renvoyé dans 'Resultat'.

Remarques

Pour que l'ouverture du fichier avec OpenFile() soit un succès, le fichier doit avoir les droits en lecture et écriture. Ceci peut devenir un problème s'il faut manipuler des fichiers sur un CD-Rom par exemple. Dans ce cas, il convient d'utiliser ReadFile() quand seule la lecture du fichier est nécessaire.

Pour écraser un fichier existant avec un nouveau fichier vide, utilisez la fonction CreateFile().

Pour ajouter des données à la fin d'un fichier existant il faut au préalable positionner le pointeur de lecture/écriture en utilisant l'option #PB_File_Append.

Exemple

  If OpenFile(0, "Test.txt")    ; Ouvre un fichier existant ou en crée un nouveau s'il n'existait pas
    FileSeek(0, Lof(0))         ; Place le pointeur à la fin du fichier en utilisant le résultat de Lof() 
    WriteStringN(0, "... une autre ligne à la fin du fichier.")
    CloseFile(0)
  EndIf

Voir aussi

CreateFile(), ReadFile(), CloseFile()

OS Supportés

Tous

<- Lof() - File Index - ReadAsciiCharacter() ->