WriteString()

Syntax

Ergebnis = WriteString(#Datei, Text$ [, Format])
Beschreibung
Schreibt einen String in eine Datei.

Parameter

#Datei Die Datei, in welche geschrieben werden soll.
Text$ Der zu schreibende String.
Format (optional) Das Format, in welchem der String geschrieben werden soll. Dies kann einer der folgenden Werte sein: 
  #PB_Ascii  : Schreibt den String im ASCII-Format
  #PB_UTF8   : Schreibt den String im UTF8-Format
  #PB_Unicode: Schreibt den String im UTF16-Format
Wenn dieser Parameter nicht angegeben wird, dann wird der String im UTF8-Format geschrieben.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die Operation erfolgreich war, und 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()). Das abschließende "Null" Stringzeichen wird nicht in die Datei geschrieben.

Um ein BOM ("Byte Order Mark" oder auch "Kennzeichen der Byte-Reihenfolge) einzufügen, mit dessen Hilfe später das String-Kodierungs-Format der Datei identifiziert werden kann, verwenden Sie die Funktion WriteStringFormat()
Um einen String einschließlich eines Zeilenvorschubs ("Newline") zu schreiben, verwenden Sie die Funktion FastLink "WriteStringN()".

Für ein Beispiel siehe den CreateFile() Befehl.

Siehe auch

ReadString(), WriteStringN(), WriteStringFormat(), CreateFile(), OpenFile()

Unterstützte OS

Alle

<- WriteQuad() - File Inhaltsverzeichnis - WriteStringFormat() ->