WriteCharacter()

Syntaxe

Resultat = WriteCharacter(#Fichier, Caractere.c [, Format])

Ecrit un caractère (1 octet non signé en mode ascii ou 2 octets non signés en mode unicode).

Arguments

#Fichier	Le fichier à utiliser.
Caractere.c	La valeur du caractère à écrire.
Format (optionnel)	Le format du caractère à écrire. Peut être l'une des valeurs suivantes: #PB_Ascii : 1 octet non signé. #PB_Unicode: 2 octets non signés (par défaut, voir unicode). #PB_UTF8 : entre 1 et 4 octets non signés. 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 ou zéro si elle a échoué.

Remarques

Attention la limite est de 2 Go.

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()).

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() 
    WriteCharacter(0,65)
    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 ReadCharacter(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

ReadCharacter(), WriteAsciiCharacter(), WriteUnicodeCharacter(), CreateFile(), OpenFile()

OS Supportés

Tous