WriteCharacter

WriteCharacter()

Syntax

Ergebnis = WriteCharacter(#Datei, Zeichen.c [, Format])

Beschreibung

Schreibt einen Character-Wert (1 Byte in ASCII, 2 Bytes in Unicode) in eine Datei.

Parameter

#Datei Die Datei, in welche geschrieben werden soll.

Zeichen Der zu schreibende Character-Wert.
Format (optional)
Das Format des zu schreibenden Zeichens (englisch "Character"). Dies kann einer der folgenden Werte sein:
  #PB_Ascii  : 1 Byte Zeichen.
  #PB_Unicode: 2 Bytes Zeichen (Standard, siehe Unicode-Modus).
  #PB_UTF8   : Multi-Bytes Zeichen (von 1 bis zu 4 Bytes).
Wenn dieses Flag nicht gesetzt wird, dann hängt das Format für das Schreiben des Characters von der entsprechenden Einstellung des zuvor verwendeten CreateFile() bzw. OpenFile() Befehls ab.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die Operation erfolgreich war, oder Null bei einem Fehler.

Anmerkungen

Wegen des Zwischenspeicherns (Cachen) kann diese Funktion auch dann eine Erfolgsmeldung zurückgeben, wenn auf dem Ausgabegerät nicht genug Platz für die Schreib-Operation übrig ist.
Die Datei muss mit Schreib-Unterstützung geöffnet worden sein (d.h. nicht mit ReadFile()).

Für ein Beispiel siehe den CreateFile() Befehl - mit WriteCharacter() wird nur ein Character-Wert anstelle eines Strings gespeichert.

Siehe auch

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

Unterstützte OS

Alle

<- WriteByte() - File Inhaltsverzeichnis - WriteData() ->

#Datei	Die Datei, in welche geschrieben werden soll.
Zeichen	Der zu schreibende Character-Wert.
Format (optional)	Das Format des zu schreibenden Zeichens (englisch "Character"). Dies kann einer der folgenden Werte sein: #PB_Ascii : 1 Byte Zeichen. #PB_Unicode: 2 Bytes Zeichen (Standard, siehe Unicode-Modus). #PB_UTF8 : Multi-Bytes Zeichen (von 1 bis zu 4 Bytes). Wenn dieses Flag nicht gesetzt wird, dann hängt das Format für das Schreiben des Characters von der entsprechenden Einstellung des zuvor verwendeten CreateFile() bzw. OpenFile() Befehls ab.