WriteStringN()

Syntaxe

Resultat = WriteStringN(#Fichier, Texte$ [, Format])

Ecrit une chaîne de caractères dans un fichier suivie du code 'Fin de Ligne'.

Arguments

#Fichier	Le fichier à utiliser.
Texte$	Le texte à écrire dans le fichier.
Format (optionnel)	#PB_Ascii : Ecrit le texte en ASCII. #PB_UTF8 : Ecrit le texte en UTF-8. #PB_Unicode: Ecrit le texte en UTF-16. Si cet indicateur n'est pas définie, le format de lecture dépend de l'option utilisée avec CreateFile(), OpenFile() ou ReadFile().

Valeur de retour

Renvoie une valeur non nulle si l'opération a réussi et zéro si elle a échoué.

Remarques

En raison de la mise en mémoire tampon, cette fonction peut retourner une valeur avec succès même s'il n'y a pas assez d'espace disponible sur le périphérique de sortie pour l'opération d'écriture.

Le fichier doit être ouvert en utilisant une fonction d'écriture compatible (c'est à dire pas avec ReadFile()).

Vous trouverez un exemple d'utilisation avec la commande CreateFile().

Afin d'identifier plus facilement le type d'encodage d'un fichier, utilisez la commande WriteStringFormat() pour écrire un BOM (Byte Order Mark).

Exemple

  If CreateFile(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() 
    WriteString(0, "Une ligne.")
    WriteStringN(0, "... une autre ligne à la fin du fichier.")
    CloseFile(0)
  EndIf
  If ReadFile(0, "Test.txt")   ; Si le fichier peut être lu , on continue...
    While Eof(0) = 0           ; Boucle tant que la fin du fichier n'est pas atteinte. (Eof = 'End Of File') 
      Debug ReadString(0)      ; Affiche ligne par ligne le contenu du fichier
    Wend
    CloseFile(0)               ; Ferme le fichier précédemment ouvert
  Else
    MessageRequester("Information","Impossible d'ouvrir le fichier!")
  EndIf

Voir aussi

ReadString(), WriteString(), WriteStringFormat(), CreateFile(), OpenFile()

OS Supportés

Tous